This guide walks you through connecting your Shopify store to RankAI so we can publish and manage your SEO blog content. You’ll need access to your Shopify Admin portal and your RankAI dashboard.
Where to start in RankAI
In your RankAI project, open Settings in the sidebar. Under Site Integration, find Connected CMS and click Configure.
On the next screen, you’ll see All Integrations. Click the Shopify card to continue.
Step 1: Get Admin Portal URL
Go to your Shopify Admin portal and sign in. Copy the full URL from your browser’s address bar (e.g. admin.shopify.com/store/your-store-name). You’ll paste this into RankAI in Step 3.
Step 2: Create Admin Token
RankAI connects to Shopify using an Admin API access token. You’ll create a custom app in Shopify, configure the required scopes, install it, and then copy the token.
2.1 Go to Apps and open Develop apps
In your Shopify Admin, click Settings (gear icon at the bottom of the sidebar), then Apps and sales channels. Click the Develop apps button.
2.2 Create an app
On the App development page, click Create an app (under Legacy custom apps if that’s what you see).
2.3 Name the app and create it
In the modal, enter the app name RankAI AI SEO (or any name you prefer). Optionally assign an App developer. Click Create app.
2.4 Configure Admin API scopes
On the app’s Overview page, click Configure Admin API scopes.
2.5 Select content and theme scopes, then Save
Under Admin API access scopes, enable the content and theme permissions RankAI needs:
- Store content:
read_content,write_content - Themes:
read_themes,write_themes
Click Save to apply the scopes.
2.6 Install the app
Back on the app Overview, click Install app to get your Admin API access token.
2.7 Reveal and copy the Admin API access token
Open the API credentials tab. Under Admin API access token, click Reveal token once. Shopify will show the token only once—copy it immediately and save it somewhere safe. You’ll paste it into RankAI in Step 3.
Note
You can only reveal the Admin API access token once. If you lose it, you’ll need to uninstall the app and create a new one to generate a new token.
Step 3: Connect credentials
Back in your RankAI project, open the Shopify integration screen. Enter your Shopify Admin Portal URL (from Step 1) and your Admin Token (from Step 2.7), then click Connect.
Connect credentials
Enter your Shopify Admin Portal URL and Admin Token.
Admin Portal URL: Paste the full URL you copied from your browser in Step 1 (e.g. admin.shopify.com/store/your-store-name).
Admin Token: Paste the Admin API access token you revealed and copied in Step 2.7.
Click Connect. RankAI will verify the credentials and connect your store. After connecting, you’ll see the Select Shopify Blog screen—complete Step 4 below to finish setup.
Step 4: Select Shopify blog and save
On the Select Shopify Blog screen, choose which blog collection RankAI will publish to and the author name that will appear on your posts. Then save and confirm the status.
4.1 Choose blog collection and author name
Use the Blog collection dropdown to select the Shopify blog where you want RankAI to publish posts (e.g. “Knowledge”, “News”, or a custom blog). In Author name (optional), enter the name that should appear as the author on published posts (e.g. “Rankai Admin” or your brand name).
4.2 Save and confirm
Click the Save button to store your choices. When saving succeeds, the status in the top right changes from Unsaved to Saved (with a green indicator). Only when you see Saved have you completed all steps and finished the Shopify integration setup.
You can change the blog or author later from the same screen, or use Change Integration to switch to a different CMS. Once you see Saved, your Shopify integration is ready and RankAI can publish to your selected blog.
FAQ
What if the connection fails?
Double-check that (1) your Admin Portal URL is the full URL from your browser when logged into Shopify Admin, (2) you’re using the Admin API access token (not a different key), and (3) the app has the required scopes (read_content, write_content, read_themes, write_themes) and is installed.
I lost my Admin API access token. What do I do?
Shopify only shows the token once. Uninstall the app from your store, then create a new app (or create another app), configure the same scopes, install it, and reveal the new token. Paste the new token into RankAI.
Where can I get more support?
Contact your RankAI account team or check the help section in your dashboard.
