Connecting RankPill to your WordPress site is the fastest way to turn AI-generated content into live, traffic-driving blog posts. The integration allows you to push fully formatted articles—complete with featured images, SEO metadata, and proper structure—directly to your WordPress site. This eliminates the tedious work of copying and pasting, preventing typos and formatting errors while letting you schedule posts in advance or publish them instantly.
Before you begin, make sure you have:
- A WordPress site on WordPress 5.0 or later
- Administrator access to install plugins
- Your site running PHP 7.4 or later
Connecting Your WordPress Site
Navigate to Settings → Integrations in your RankPill dashboard and click Connect WordPress. You'll need to install the official RankPill plugin first:
- Go to your WordPress dashboard → Plugins → Add New
- Search for "RankPill Integration"
- Click Install Now, then Activate
- Go to RankPill in your WordPress admin menu
- Click "Generate New API Key" and copy it (starts with
rp_) - Return to RankPill, enter your WordPress site URL and API key
- Click "Test Connection" to verify, then "Connect"
Once connected, publishing is just a few clicks away. From the RankPill editor, click Publish, select WordPress, and choose to publish immediately or schedule for later. RankPill takes care of the rest, automatically handling all the formatting, media, and SEO details.
Updating Published Articles
After publishing an article to WordPress, you can update it directly from RankPill. Simply make your changes in the RankPill editor and click the "Update Article" button. Your changes will be pushed to your WordPress site automatically.
Optimizing Your Permalink Structure
WordPress's default permalink structure often includes dates or post IDs, which aren't ideal for SEO. For clean, optimized URLs:
- Go to Settings → Permalinks in your WordPress dashboard
- Select "Custom Structure"
- Enter
/%postname%/for root-level posts, or/blog/%postname%/for posts under/blog/
This changes your URLs from yoursite.com/?p=123 to yoursite.com/how-to-rank-higher/.
Customizing Published Content
Changing the Default Category: All articles are assigned to WordPress's default category (typically "Uncategorized"). To customize this, go to Posts → Categories in WordPress, find "Uncategorized", click Edit, and rename it to something that reflects your business (e.g., "Blog" or "Articles").
Pro Tip: Categories don't provide real SEO value. Most themes let you hide category labels for a cleaner look. Focus on quality content and clean URLs instead—search engines don't care about category labels.
Changing the Author Name: Articles are published using the WordPress admin account that activated the plugin. To update the author name, go to Users → Your Profile in WordPress and change your Display Name.
Troubleshooting
1. I can't find the RankPill plugin in WordPress.
Make sure you're searching in Plugins → Add New (not installed plugins) for "RankPill Integration" (the full name). You can also download it directly from wordpress.org/plugins/rankpill-integration.
2. The plugin won't activate.
Check that your WordPress version is 5.0 or later and PHP version is 7.4 or later. Contact your hosting provider to upgrade if needed. You can also try temporarily deactivating other plugins to identify conflicts.
3. My connection failed. What should I check?
Verify the plugin is activated in Plugins in WordPress, then generate a fresh API key in WordPress → RankPill menu. Use your main site URL (e.g., https://yourblog.com) without /wp-admin or trailing slashes. Check if security plugins like Wordfence or iThemes Security are blocking API requests.
4. My articles aren't publishing successfully.
Check that your API key hasn't been revoked in WordPress → RankPill. Verify your WordPress user has the "Administrator" role and that your site has enough disk space for images.
Frequently Asked Questions
1. Can I publish to multiple WordPress sites?
Currently, each RankPill business can connect to one WordPress site. Contact support if you need to manage multiple sites.
2. Can I update articles after publishing?
Yes! After publishing, click the "Update Article" button to push your changes directly to WordPress. RankPill automatically finds and updates the correct post.
3. Will this slow down my WordPress site?
No. Publishing happens via the REST API in the background and doesn't impact your site's front-end performance or page load speeds.
4. What happens if my WordPress site is down when an article is scheduled?
RankPill will retry publishing failed articles automatically. Articles remain in "scheduled" status until successfully published.
5. Can I revoke API access?
Yes. Go to RankPill in your WordPress dashboard and click "Revoke" next to the active API key. This immediately disconnects RankPill from your site.
6. Is the plugin secure?
Yes. The plugin follows WordPress security best practices, uses secure API key authentication, and only accesses data needed for publishing. API keys can be revoked instantly if compromised.
For additional support, contact our team through the in-app support chat.