On this page
  1. Before you start
  2. Connect in three steps
  3. What NeoRank can change
  4. Security
  5. Check, pause, revoke
  6. Common problems

Features

Connect WordPress (NeoRank Connect plugin)

Coming soon — The NeoRank Connect plugin writes the fixes you approve in NeoRank to WordPress, through signed calls, and lets you undo everything for 30 days.

Before you start

  • WordPress 6.0 or later, PHP 8.0 or later, site on HTTPS.
  • A WordPress administrator account (the plugin's screen requires the “manage options” capability).
  • In NeoRank: the workspace Administrator or Strategist role, and a site not already connected through another platform.

Connect in three steps

  1. In WordPress, install and activate the NeoRank Connect plugin (Plugins › Add New).
  2. In NeoRank, Settings › Connectors, WordPress card: “Generate a pairing code” for the site. The code is valid 10 minutes, once; the “NeoRank address” is shown beside it.
  3. In WordPress, Settings › NeoRank Connect: paste the code and the NeoRank address, tick the consent, then “Pair with NeoRank”. The plugin exchanges the code for a shared secret.
  4. Back in NeoRank, “Check the connection”: NeoRank calls your site with a signed request; the card turns Connected.

What NeoRank can change

FieldWhere
SEO title and meta descriptionPublished posts and pages — in Yoast SEO or Rank Math fields when one is active, otherwise printed by the plugin
Alt textMedia library images
JSON-LD structured dataOrganization, Article, FAQPage, BreadcrumbList
301 redirectsOnly for pages that return 404
One internal linkIn a post's content (a WordPress revision is kept)
/llms.txtThe file, generated from your pages

Security

  • Every NeoRank call is signed (HMAC-SHA256 over the method, route, time, a single-use nonce and the body hash), valid 5 minutes, refused when replayed. The plugin's answers are signed too.
  • The secret is created at pairing, encrypted in NeoRank's connector vault and stored outside autoload in WordPress.
  • Before any write NeoRank sends the value it last read: if it changed in WordPress meanwhile, the write is refused.
  • The plugin sends data to NeoRank only at pairing (the code, the site's address, the plugin version) and in answer to signed calls (the current value of the field being fixed). It purges the fixed page's cache.

Check, pause, revoke

  • Manage › Check the connection: a signed call reads the plugin's state back.
  • Pause / Resume: nothing is applied on this site while paused.
  • Revoke (two-click confirmation): the plugin is disconnected, NeoRank can no longer change anything. “Disconnect” in Settings › NeoRank Connect does the same; uninstalling the plugin erases everything it stored.

Common problems

MessageWhat to do
Waiting for the pluginThe plugin is paired but has not answered the signed call yet: check it is active on the site's domain, then “Check again”.
The signed call was refused: pair the plugin again.The secret no longer matches (plugin reinstalled or disconnected): generate a new code and pair again.
The site is unreachable / took too long to answerCheck the site is online over HTTPS and that a firewall or security plugin does not block the WordPress REST API, then retry.
The site answered from another domain than its ownThe site's domain in NeoRank must be WordPress's (Settings › General); fix one or the other.
Your plan's number of connected sites is reachedRevoke another site or change plan (Pricing).
Code expiredThe code is valid 10 minutes and once: click “New pairing code”.

Need more help?

A question the documentation does not answer? The help center covers every dashboard page, and support answers the rest.