Connect WordPress
How to securely connect your WordPress site to RankWriting, including permission requirements and troubleshooting.
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
- Open the RankWriting WordPress Plugin download page
- Click Download plugin ZIP
- In WordPress admin, go to Plugins → Add New → Upload Plugin
- Upload and activate the plugin
Enter your connect token
- In WordPress, go to Settings → RankWriting
- Paste the Connect Token from your Dashboard
- Click Connect to RankWriting
You'll be redirected back to the Dashboard automatically. Your site will show as Connected.
Requirements
- WordPress 6.0+ (REST API must be enabled)
- PHP 8.0+
- 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.