Integrating with Shopify

Connecting RankPush to Shopify turns your AI-generated content into published blog posts that drive traffic to your online store. Every finished article lands on your Shopify blog fully formatted, with images, meta description, SEO title, slug and headings in place. There is no copying and pasting, and you choose whether articles go live instantly or wait hidden for review.

The recommended way to connect is Marz Blog Writer, a free app on the Shopify App Store. You install it, create an API key inside it, and paste the key into RankPush. There is no developer account to set up and no app of your own to build.

Before you begin, make sure you have:

  • A Shopify login that can install apps on the store: the store owner, or a staff account with permission to install apps
  • At least one blog set up in Shopify (Content → Blog posts → Manage blogs)

The other ways to connect have their own requirements, listed in their sections below.

Connect with Marz Blog Writer (recommended)

Marz Blog Writer is a free app by Marz Agency on the Shopify App Store. RankPush publishes through it, so RankPush never holds your Shopify login or a Shopify access token for your store, and you can revoke the key inside the app at any time.

  1. 1

    Install Marz Blog Writer

    Open Marz Blog Writer on the Shopify App Store, click Install, and approve the install in your Shopify admin. It is free, with no paid tier, and asks for one permission: to read and write your blog content.
  2. 2

    Open the app

    Shopify usually opens it right after the install. Later on, find it in your Shopify admin under Apps, then Marz Blog Writer. It opens on the Write a blog post page.
  3. 3

    Create an API key

    Click Connect an app at the top of the page (it is also in the sidebar, under Marz Blog Writer). Under Create a key, type a name you will recognize, such as “RankPush”, in What is it for?, then click Create key.
  4. 4

    Copy the key

    A box titled Copy your key now shows the key. It starts with bw_live_. Copy all of it now: this is the only time it is shown. If you lose it, revoke it and create a new one.
  5. 5

    Paste it into RankPush

    In RankPush, go to Settings → Integrations → Shopify (or pick Shopify on the Connect your blog step while you set up your website). On the Connect with the Marz Blog Writer app card, paste the key into API key and click Connect. RankPush checks the key with the app and loads your blogs.
  6. 6

    Confirm the store and pick a blog

    RankPush shows the Store the key belongs to. If it isn't yours, stop and click Back: the key was created on the wrong store. Otherwise choose the Blog to publish to, and under Publishing behavior pick Publish live immediately or Create hidden for review.
  7. 7

    Connect

    Click Yes, connect this store. The Shopify page then shows Connected to Shopify, with Marz Blog Writer app as the method. New articles now publish to the blog you picked.

To stop publishing, click Disconnect in RankPush under Settings → Integrations → Shopify. Then, if you like, revoke the key in the app (open Connect an app, then under Your keys click Revoke and Really revoke?). Revoking the key without disconnecting makes every new article fail to publish. Reinstalling Marz Blog Writer ends every key it issued before, so after a reinstall create a fresh key and paste it on the Shopify page in RankPush. If that page still says Connected to Shopify, click Disconnect first.

Other ways to connect

Use one of these only if Marz Blog Writer isn't an option, for example when the store can't install apps from the Shopify App Store, or you prefer to run your own app. Both start on the same page: in RankPush go to Settings → Integrations → Shopify and, under Other ways to connect, click Connect with your own Shopify app (Client ID + Secret).

Your own app in the Shopify Dev Dashboard

You create your own app in the Shopify Dev Dashboard (about three minutes), then paste its Client ID and Client Secret into RankPush. RankPush handles the token exchange and refresh automatically from then on.

This video shows the Dev Dashboard setup, start to finish, in under 2 minutes.

Which path is right for you? The steps below are for the owner of the store's Shopify organization. Managing a store you don't own (agency or staff account)? Skip these steps. Ask the owner to install Marz Blog Writer and send you a key. If the owner already has an Admin API access token with the read_content and write_content scopes, you can use “Advanced: connect with an Admin API access token” on the connect form instead (see Admin API access token).

  1. 1

    Open the Dev Dashboard

    Go to dev.shopify.com/dashboard and log in with the Shopify account that owns your store. Staff accounts see “Your account doesn't have developer access yet”. The simplest way around it is to ask the owner to install Marz Blog Writer and send you a key. You can also ask the owner to grant you Developer access (Shopify admin → Settings → Users), or connect with an Admin API access token (see the troubleshooting note below).
  2. 2

    Create a new app

    Click Create app, choose Start from Dev Dashboard, give it a name (e.g. “RankPush”) and click Create.
  3. 3

    Configure API scopes and release

    On the version page, set the App URL to https://rankpush.ai/docs/shopify — that's the page that opens when you click the app inside Shopify admin. Under Access → Select scopes, search for “content” and tick read_content and write_content, click Done, then click Release to create a version.
  4. 4

    Copy your credentials

    Open your app's Settings page on the Dev Dashboard. Copy the Client ID and the Client Secret.
  5. 5

    Install the app on your store

    First, on the app's Overview page, find the Distribution card and click Select distribution method → choose Custom distribution and enter your store's .myshopify.com address (live stores can't install an app without this; development stores skip it). Then go to Home, click Install, pick your store and confirm. The “this app hasn't been reviewed” notice is normal — it's your own private app.
  6. 6

    Connect in RankPush

    1. Go to Settings → Integrations → Shopify in your RankPush dashboard and, under Other ways to connect, click Connect with your own Shopify app (Client ID + Secret)
    2. Enter your store URL — the your-store.myshopify.com address, shown in Shopify admin under Settings → Domains — plus the Client ID and Client Secret
    3. Click Connect — RankPush validates the credentials and fetches your blogs
    4. Select which blog to publish to (and whether articles go live immediately or hidden for review)
    5. Click Complete setup

Admin API access token

Use this if the store owner already has an access token for you. If you manage a store you don't own, the simpler route is for the owner to install Marz Blog Writer and send you a key (see Connect with Marz Blog Writer). The store owner creates the token (it starts with shpat_ and needs the read_content and write_content scopes) and sends it to you with the store's .myshopify.com address. The owner's steps are under Troubleshooting below.

  1. In RankPush, go to Settings → Integrations → Shopify and, under Other ways to connect, click Connect with your own Shopify app (Client ID + Secret)
  2. Click Advanced: connect with an Admin API access token instead
  3. Enter the store URL and the Admin API access token, then click Connect
  4. Choose the blog and the publishing behavior, then click Complete setup

Store URL Format

Only your own app and the access token ask for a store URL. With Marz Blog Writer there is nothing to type: RankPush reads the store from the key. Where a store URL is asked for, you can enter it in any of these formats:

  • your-store.myshopify.com
  • https://your-store.myshopify.com
  • your-store (we add .myshopify.com for you)

Using a custom domain? You still need your original .myshopify.com URL for the API connection — you'll find it in Shopify admin under Settings → Domains.

Selecting Your Blog

During setup you choose which blog RankPush publishes to. Shopify stores can have several blogs — “News” (the default), “Blog”, “Articles”, or custom names you've created. RankPush maps each article to Shopify's structure automatically:

  • Title, content (HTML) and excerpt
  • Slug (handle) — set once at creation and never changed by later updates
  • Featured image with descriptive alt text
  • SEO title and meta description in the standard global.title_tag / global.description_tag metafields every theme reads

Updating Published Articles

After an article is published to Shopify you can keep editing it in RankPush. Make your changes in the editor and click Update Article — the same Shopify article is updated in place, and its URL never changes.

Publishing Options

Publish live immediately

Articles appear on your blog the moment they're ready — full autopilot.

Create hidden for review

Articles are created unpublished. Review them in Shopify admin under Content → Blog posts and make them visible when you're happy. You pick this during setup, on the same step as the blog. To change it later, disconnect and reconnect.

Troubleshooting

With Marz Blog Writer

›“Marz Blog Writer didn't accept that key”
The key was copied only in part, was revoked, or was created before the app was last reinstalled (a reinstall ends every older key). Keys are shown once, so you can't copy the same one again: open Marz Blog Writer, click Connect an app, create a new key and paste that one.
›“Marz Blog Writer has lost its connection to this store”
Marz Blog Writer has lost its own connection to your store. Your key is fine. Open Marz Blog Writer once in your Shopify admin. That reconnects it. Then click Connect in RankPush again with the same key. Only create a new key if you no longer have this one, and if you do, revoke the old one under Your keys.
›“This store has no blog yet”
Shopify keeps articles inside a blog, and a store can have none. Create one in Shopify admin under Content → Blog posts → Manage blogs → Add blog, then click Connect in RankPush again. The same key still works.
›The store RankPush shows isn't mine
Stop and click Back. The key was created in another store's Marz Blog Writer. Open the app from your own store's Shopify admin, create a key there, and paste that one instead.
›I can't install Marz Blog Writer on the store
Installing an app takes the store owner, or a staff account with permission to install apps. Ask the owner to install it and send you a key, or to give your account that permission. If the store can't install apps from the Shopify App Store at all, use your own app or an access token instead (see Other ways to connect).
›“You have the maximum of 5 keys”
A store can hold up to 5 active keys. In Marz Blog Writer, open Connect an app and, under Your keys, click Revoke and then Really revoke? on a key you no longer use. Check the name first: revoking the key RankPush uses stops publishing. Then create the new key.
›Publishing stopped and Shopify shows as not connected in RankPush
The key stopped working. It was revoked, or Marz Blog Writer was uninstalled or reinstalled. The next publish then fails, and RankPush shows Shopify as not connected. Open Marz Blog Writer, click Connect an app, create a fresh key, and paste it on the Shopify page in RankPush (Settings → Integrations → Shopify). It replaces the old connection. If the page still says Connected to Shopify, click Disconnect first. Articles already on your blog are not affected.

With your own app or an access token

›“Your account doesn't have developer access yet” on the Dev Dashboard
Your Shopify login isn't the store owner and hasn't been granted developer access, so the Dev Dashboard won't let you create apps. Four ways forward: (1) the simplest: ask the owner to install Marz Blog Writer and send you a key, then paste it on the Marz Blog Writer card; (2) ask the store owner to grant your user Developer access under Shopify admin → Settings → Users; (3) have the owner run steps 1 to 5 themselves and send you the Client ID, Client Secret and store URL for step 6; or (4) skip the app entirely: an owner-created Admin API access token (starts with shpat_, needs the read_content and write_content scopes) works via “Advanced: connect with an Admin API access token” on the connect form.
›How does the store owner create an Admin API access token? (for agencies/staff)
Only the store owner (or someone with full admin) can create one, because it's a Shopify credential. Owner steps: in Shopify admin open Settings → Apps and sales channels → Develop apps (allow custom app development if prompted) → Create an app → under Configuration → Admin API integration enable read_content and write_content → Install app → on the API credentials tab reveal the Admin API access token (it is shown once, so copy it) and send it to whoever manages RankPush, together with the store's .myshopify.com address. If the store's admin doesn't have a “Develop apps” page (newer stores), the owner can install Marz Blog Writer and send you a key instead, or run steps 1 to 5 of the Dev Dashboard guide above and hand over the Client ID and Client Secret. Those work pasted by anyone, because the app lives in the store's own organization.
›“This app can't be installed yet — the app developer needs to select a distribution method”
Live stores require the app to have a distribution method before installing (development stores don't, which is why the video skips this). On the app's Overview page open the Distribution card → Select distribution method → Custom distribution → enter your store's .myshopify.com address, then install again. Note: custom distribution permanently ties the app to that one store — which is exactly what you want for this private connector.
›Connection fails at “Connect” (your own app)
Double-check the three fields: the store URL must be the .myshopify.com address (not a custom domain), and the Client ID / Client Secret must come from your app's Settings page on the Dev Dashboard. Then confirm the app is installed on your store(step 5) — credentials only work after installation.
›“Shopify rejected the Client ID / Client Secret”
Three common causes: (1) the app was created but not yet released or installed. Versions should show an active version, and Home should show it installed on your store. (2) A copy and paste slip. Re-copy both values from the app's Settings page. (3) The app was created in a different Shopify organization than the one that owns your store. Shopify only honors Client ID/Secret for same-organization apps, even when the app is installed. In that case the simplest fix is to have the store owner install Marz Blog Writer and send you a key. Otherwise create the app inside the store's own organization, or connect with an owner-created Admin API access token (“Advanced” on the connect form).
›My blogs don't show up during setup
Your store may not have a blog yet. Create one in Shopify admin under Content → Blog posts → Manage blogs → Add blog, then click Back and Connect again. If you have blogs but still see none, the app is probably missing the read_content scope: add it, release a new version, reinstall, and reconnect.
›I use a custom domain — which URL do I enter?
Always the .myshopify.com URL. Your custom domain keeps working for visitors; the API connection just needs Shopify's original address.

Either way

›Articles fail to publish
Open the article from the calendar. The reason is shown at the top, for example a revoked key, an uninstalled app or a missing write_content scope. Fix it on the Shopify side, then click Publish again. With Marz Blog Writer that usually means creating a fresh key and reconnecting. With your own app, scope changes always need a new release and a reinstall.
›Where do my articles go?
To the blog you selected during setup, under Content → Blog posts in Shopify admin. Articles set to “hidden for review” are there too, just unpublished.

Frequently Asked Questions

›Can I publish to multiple Shopify stores?
Each RankPush website connects to one store. Running several stores? Add each as its own website in RankPush (volume pricing applies) and connect them separately.
›How quickly do articles appear on my live store?
Immediately when set to “Publish live immediately” — the article is live on your blog seconds after RankPush publishes it. Hidden-for-review articles appear as soon as you set them visible in Shopify.
›Which Shopify plans does this work on?
Any Shopify plan that includes the online store and its blog. The Starter plan has no blog, so there is nothing to publish to. Marz Blog Writer itself is free, with no paid tier. Creating your own app in the Dev Dashboard works on the same plans, including trials.
›What happens if I uninstall the app from my store?
Articles can no longer publish to your store, and articles already on your blog stay where they are. If you are stopping on purpose, click Disconnect in RankPush before you uninstall, so new articles don't fail. Uninstalling Marz Blog Writer revokes every key it issued, so to resume, install it again, create a fresh key, and paste it in RankPush under Settings → Integrations → Shopify (if that page still says Connected to Shopify, click Disconnect first). With your own app, reinstall it and reconnect the same way.
›Can I switch to a different blog later?
Yes. Disconnect and connect again, and pick the new blog during setup. With Marz Blog Writer, use the same key. If you no longer have it, create a new key and revoke the old one under Your keys, so it does not use up one of your 5 key slots. Existing articles stay where they were published.

Security

  • With Marz Blog Writer, RankPush stores only the API key you paste, encrypted. It never holds your Shopify login or a Shopify access token, and you can revoke the key in the app at any time
  • Marz Blog Writer asks Shopify for one permission, to read and write blog content. The app you create yourself needs only read_content and write_content
  • With your own app, the Client Secret is stored encrypted and only used to mint short-lived tokens at publish time. It can't be read back out of RankPush
  • Revoke access at any time: disconnect in RankPush, then revoke the key or uninstall the app in Shopify admin. Disconnecting never deletes published articles

Other integrations

Publishing somewhere else? See WordPress, Webflow, or the API Webhook for any custom CMS. Need a hand? Email support@rankpush.ai.

Put your content on autopilot

Connect your site once — RankPush researches keywords, writes SEO articles, and publishes them for you every day.

Get started for free