Docs/Connect Wordpress

Connect WordPress

RankWriting connects to your WordPress site via a lightweight plugin that handles authentication and publishing through the WordPress REST API.

How it works

Once connected, RankWriting generates a unique API key for your site. The plugin stores a secure hash of that key in WordPress. All publishing requests are verified against that hash — your WordPress password is never stored on RankWriting servers.

Install the plugin

  1. ·Go to RankWriting Dashboard → Sites → Add site
  2. ·Click Download Plugin to get the .zip file
  3. ·In WordPress admin, go to Plugins → Add New → Upload Plugin
  4. ·Upload and activate the plugin

Enter your connect token

  1. ·In WordPress, go to Settings → RankWriting
  2. ·Paste the Connect Token from your Dashboard
  3. ·Click Connect to RankWriting

You'll be redirected back to the Dashboard automatically. Your site will show as Connected.

Requirements

  • ·WordPress 5.0+ (REST API must be enabled)
  • ·User role must be Editor or Administrator

Troubleshooting

Connect Token expired — Tokens expire after 15 minutes. Go back to Dashboard → Sites → Add site and generate a new one.

Site shows as Disconnected — Make sure the plugin is activated, not just installed. Check Plugins → Installed Plugins.

REST API blocked — Some security plugins (Wordfence, iThemes Security) disable the REST API. Whitelist rankwriting.com in their settings.

Multisite — Install and activate the plugin on each sub-site individually. Connect Tokens are per-site.