Documentation

Applying Links

Apply approved links to your WordPress content

How Applying Works

WPLink applies links by updating your WordPress content via the REST API. The process is:

  1. 1Find the exact anchor text location in the post HTML
  2. 2Wrap the anchor text in an <a> tag with the target URL
  3. 3Save the updated content back to WordPress

Previewing Changes

Before applying, you can preview exactly what will change:

  1. 1

    Click "Preview" on any opportunity

    Opens a preview dialog showing the change

  2. 2

    Review the before/after

    See the original text and how it will look with the link added

  3. 3

    Confirm or cancel

    Apply if it looks good, or go back to review

Preview Example

Before

...After installing WordPress, you'll need to choose a theme that matches your brand...

After

...After installing WordPress, you'll need to choose a theme that matches your brand...

Applying Single Links

To apply one link at a time:

  1. 1

    Approve the opportunity first

    Click the checkmark icon to change status from Pending to Approved

  2. 2

    Click the play icon to apply

    Once approved, the play button appears. Click it to add the link to WordPress.

Batch Applying

Apply multiple links at once:

  1. 1

    Approve the opportunities you want

    Click the checkmark on each one to approve

  2. 2

    Click "Apply Page (N)"

    This button appears when you have approved opportunities on the current page. It applies all of them.

Note: Batch apply processes links one at a time to avoid conflicts. If two opportunities target the same anchor text in the same post, only the first will be applied.

Troubleshooting

"Anchor text not found"

The exact text may have changed since the analysis. Re-crawl and re-analyze to get fresh opportunities.

"Text already linked"

The anchor text already has a link (perhaps added manually). WPLink won't create duplicate links.

"Permission denied"

Your WordPress user may not have edit permissions. Check your user role in WordPress.

"Connection failed"

Check your internet connection and verify your WordPress site is accessible.

Reverting Changes

If you need to undo an applied link:

Manual removal: Edit the post in WordPress and remove the link from the block editor.

Revision history: WordPress keeps revisions of your posts. Go to the post editor, click "Revisions" in the sidebar, and restore a previous version.

Best Practices

  • Always preview before applying, especially for batch operations
  • Start with a few links to verify they look correct on your site
  • Check your site after batch applying to ensure everything looks good
  • Keep your WordPress revisions enabled for easy rollback
  • Re-analyze periodically as you add new content

That's it

You've covered all the basics. Check the other docs if you need more details.

Back to Documentation