WordPress

Grandranker publishes articles straight to your self-hosted WordPress site as posts. There are two ways to connect: the WordPress Plugin (recommended, no credentials to copy) or the REST API method with an Application Password. Both live under Integrations → Add New Integration at app.grandranker.com/integrations/create.

How to Connect

Option 1: WordPress Plugin (recommended)

1. In Grandranker, open Integrations → Add New Integration and pick WordPress Plugin.
2. Click Install on WordPress. This opens the Grandranker plugin in your WordPress admin. Click Install Now, then Activate.
3. Back in Grandranker, click I've installed it. A connection key is generated for you. Copy it now. It won't be shown again.
4. In WordPress, open Grandranker in the admin sidebar, paste the connection key, and click Save & Connect.
5. Grandranker shows "Waiting for your WordPress site to connect…" and picks up the connection automatically within a few seconds. You'll see a green Connected to WordPress banner when it's done.

After connecting you can set a Publish category. All articles are published under this WordPress category. Leave it blank to use "Blog".

Option 2: REST API with an Application Password

1. In WordPress, log in and go to Users → Profile, scroll to Application Passwords, enter a name (e.g. "GrandRanker"), and click Add New Application Password. Copy the generated password. It won't be shown again.
2. In Grandranker, open the WordPress REST API integration page (linked as "self-hosted WordPress" from the WordPress.com integration page).
3. Fill in Site URL (e.g. https://yourblog.com), Username (the WordPress user you logged in with), and Application Password.
4. Choose a Default Status (Draft or Published) and optionally a Default Category.
5. Click Test Connection to verify the credentials, then Save & Connect.

Publishing & Verifying

Once connected, open any generated article and click Publish. It's pushed to your WordPress site as a new post using your default status and category. If your default status is Draft, the post lands in WordPress as a draft for you to review and publish there. After connecting with existing credentials, the Default Category field turns into a dropdown of your real WordPress categories.

To verify, open your WordPress admin → Posts and confirm the new post appears with the expected category.

Troubleshooting

"This looks like a WordPress.com hosted site"

Application Passwords don't work on WordPress.com-hosted sites. If your Site URL ends in .wordpress.com, use the WordPress.com integration instead. It connects via OAuth with one click. Grandranker shows this banner automatically when it detects a WordPress.com URL.

Test Connection fails

• Check the Site URL is the exact address of your WordPress installation, including https://.
• Confirm the username matches the user who created the Application Password.
• Paste the Application Password exactly as generated (spaces are fine).
• Some security plugins (e.g. firewall or REST API blockers) disable the REST API or Application Passwords. Temporarily allow the REST API and try again.

Plugin connection never completes

If the "Waiting for your WordPress site to connect…" state doesn't resolve, make sure you pasted the key into the Grandranker page in the WordPress sidebar and clicked Save & Connect there. If you lost the key, generate a new one in Grandranker and paste the new value.

Articles publish but land in the wrong category

Set the Default Category (REST API method) or Publish category (plugin method) in the integration settings.

Questions? Contact us at [email protected].