Publishing integrations

Shopify

Shopify stores can have several blogs. The connection carries the Admin API token and which blog to post into.

Create a custom app#

  1. In your store admin, open Settings → Apps and sales channels.
  2. Click Develop apps, then Create an app. Name it Rankli.
  3. Open Configuration → Admin API integration and click Configure.
  4. Grant write_content. That is the scope that covers blogs, articles and pages — and it is the only one we ask for. We do not read orders, customers or products.
  5. Save, then open API credentials and click Install app.
  6. Reveal and copy the Admin API access token. It starts shpat_ and is shown once.

If Develop apps is greyed out, your staff account lacks the “Manage and install apps” permission. A store owner can grant it, or create the app for you.

Have a blog to post into#

A new Shopify store often has no blog at all. Create one under Online Store → Blog posts → Manage blogs → Add blog before connecting; a store with no blog fails the connection test with exactly that message.

Connect it#

  1. In Rankli, open Integrations → New integration → Shopify.
  2. Store URL — your-store.myshopify.com. The .myshopify.com address, not your custom domain.
  3. Admin API access token — the shpat_… value.
  4. Blog — we list the blogs on the store; pick one. Leave it empty and the first blog is used.
  5. Publish mode — published, or hidden for review.
  6. Save. We list the store’s blogs as the connection test, which also proves the scope.

What lands on your store#

FieldWhere it goes
TitleThe article title.
BodyThe article body as HTML.
SlugThe article handle.
Meta descriptionThe SEO description on the article.
Hero imageUploaded to Shopify and re-hosted on their CDN as the article image.
In-body imagesLeft at their original URLs — Shopify only re-hosts the featured image.
TagsFrom the article’s keyword cluster.
AuthorThe store name, unless the connection sets one.

When it does not work#

401

The token was rotated, or the custom app was uninstalled. Reinstall and copy the new token.

403

The app is missing write_content. Add the scope, save, and reinstall the app — a scope change does not take effect until the app is reinstalled.

404

The store URL is wrong (a custom domain rather than the .myshopify.com one), or the blog was deleted.

Rate limited

Shopify’s Admin API is leaky-bucket rate limited. We back off and retry; a scheduled article is not lost because the store was busy.