Set up WordPress + Shopify integration

Write articles in the AI Content Editor and then copy them manually into the CMS? Unnecessary. Rankion has native integrations for WordPress and Shopify: store the token once, then push articles with a single click (or one API call) — as draft or live.

WordPress: set up an application password

WordPress (since 5.6) ships application passwords in core. Here's how to create one:

1. WP Admin → Users → Profile
2. Scroll down to Application Passwords
3. Name: Rankion, then Add new application password
4. You get a 24-character token like xxxx xxxx xxxx xxxx xxxx xxxx — copy it immediately, it won't be shown again

In Rankion: Settings → Integrations → Add WordPress. Enter:

• Site URL: https://your-blog.com
• Username: your WP username
• Application password: the token you just generated

Hit the Test button. If green: you're live. If red, see the troubleshooting section below.

Note: Creating a CMS integration currently runs only through the UI (Settings → Integrations). A dedicated POST /api/v1/integrations setup endpoint is (as of now) not yet publicly available. Once the integration is created, you can reference it via cms_integration_id in POST /api/v1/articles/{article_id}/publish — see the next section.

Shopify: Admin API access token

Shopify needs a custom app:

1. Shopify Admin → Settings → Apps and sales channels → Develop apps
2. Create an app → name: Rankion Publisher
3. Configure Admin API scopes → at minimum: write_content, read_content, write_files, read_files
4. Install app → you get an Admin API access token

Enter it in Rankion under Settings → Integrations → Shopify:

• Shop domain: your-shop.myshopify.com
• Admin API token: the token you just generated

Publish flow

Once the integration is in place, you have a Publish button in the editor. Via the API:

curl -X POST https://rankion.ai/api/v1/articles/{article_id}/publish \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cms_integration_id": 42,
    "status": "draft"
  }'

status is either draft or publish. Recommendation: start as draft, do the final review in the CMS, then go live.

Important: if a publish is already in flight (e.g. because a previous call is hanging), you get HTTP 409 Conflict back. Just wait a moment (15–30 seconds) and try again — Rankion serializes publishes per article so you don't get duplicates.

Featured image

If your article has a generated hero image (from the AI Content Editor), it is automatically uploaded as the featured image on publish — as the post thumbnail in WordPress, as the article image in Shopify.

If you don't want that, set "featured_image": false in the publish body.

Troubleshooting

Auth failure (401 / 403)

• WordPress: did you copy the application password correctly with spaces? Some WP setups accept both variants (with/without spaces), some don't — try both.
• WordPress: is the REST API reachable? Test: curl https://your-blog.com/wp-json/wp/v2/posts must return JSON. If 404 → re-save permalinks (Settings → Permalinks → Save).
• Shopify: does the app token actually have the write_content scope?

Image upload failure

• WordPress: the user needs the upload_files capability. Standard for editor / admin, restricted for author.
• Shopify: forgot the write_files scope? Reinstall the custom app.
• Both: featured images > 8 MB are rejected — Rankion compresses beforehand, but with very restrictive server limits double-check anyway.

Publish stays stuck on "processing"

After 5 minutes: restart the jobs (in the UI via the action menu → "Retry Publish") or contact support.

Full editor docs in AI Content Editor, API reference for articles under Articles API.