Docs/CMS Integrations/Shopify Integration

Shopify Integration

CMS Integrations
5 min read

Shopify Integration

Connect iContentForge directly to your Shopify store to automatically publish AI-generated articles to your blog. This integration uses the Shopify Admin API to create and manage blog posts, allowing you to maintain a consistent content schedule without manual intervention.

Prerequisites

Before you begin, ensure you have:

  • An active Shopify store with a blog module (e.g., "News").
  • Admin access to your Shopify store to create a custom app.
  • An iContentForge project with articles in the Ready status.

Step 1: Generate Shopify API Credentials

You need to create a custom app in your Shopify admin to obtain an API access token with the correct permissions.

  1. Log in to your Shopify Admin dashboard.
  2. Navigate to Settings > Apps and sales channels.
  3. Click Develop apps (for Shopify Plus) or Create an app under the "Custom apps" section.
  4. Configure your app:
    • Enter an App name (e.g., "iContentForge Blog Publisher").
    • Set the App URL to https://app.icontentforge.com.
  5. Configure Admin API scopes. This is the most critical step. You must add the following scopes:
    • write_content - Allows iContentForge to create and publish blog posts.
    • read_content - Allows iContentForge to fetch your blog list and verify connection.
  6. Click Save.
  7. On the app overview page, click Install app.
  8. After installation, your Admin API access token will be displayed. Copy this token immediately, as it will only be shown once.
⚠️

Security Alert: Your Admin API access token is a sensitive credential. Treat it like a password. You will enter it directly into iContentForge, and it is stored encrypted in our database. Never share it publicly or commit it to version control.

Step 2: Connect in iContentForge

With your API token ready, you can now establish the connection from your iContentForge project.

  1. In your iContentForge dashboard, go to your Project Settings.
  2. Navigate to the CMS Integration tab.
  3. Select Shopify from the list of available CMS platforms.
  4. In the connection form, enter the required details:
    • Shopify Store Domain: Enter your store's .myshopify.com domain (e.g., your-store.myshopify.com). Do not include https://.
    • Admin API Access Token: Paste the token you copied in Step 1.
  5. Click Verify Connection.
📸

iContentForge Shopify connection form showing fields for domain and API token

If successful, iContentForge will fetch a list of blogs available in your store.

Step 3: Select Target Blog & Configure Settings

After verification, configure how articles are published.

  1. Select Blog: Choose the target blog (e.g., "News") from the dropdown menu.
  2. Configure Default Author (Optional): If your Shopify blog requires an author field, you can set a default author name here. This will be applied to all articles published via this integration.
  3. Configure Drip Feed (Optional): Enable the Drip Feed scheduler to automatically publish ready articles from your queue at a steady pace (approximately every 5 minutes).
  4. Click Save Configuration.

Your integration is now active. Articles with a status of Ready will be sent to your selected Shopify blog.

Article Publishing Workflow

Once connected, the publishing flow is automatic:

  1. An article in your iContentForge project moves to the Ready status.
  2. iContentForge uses the Shopify API to create a new article draft within your selected blog.
  3. The article's HTML content, title, SEO title, and meta description are transferred.
  4. The article is immediately published to your Shopify blog (unless you are using Drip Feed, which controls the timing).
  5. The article status in iContentForge updates to Published.

You can view and manage all published articles directly within your Shopify Admin under Online Store > Blog posts.

Troubleshooting

IssueLikely CauseSolution
"Connection Failed"Incorrect store domain or invalid API token.Double-check your .myshopify.com domain and ensure the token was copied correctly. Regenerate the token if needed.
"No blogs found"The API token lacks the read_content scope, or the store has no blogs.Reinstall the custom app in Shopify and ensure both read_content and write_content scopes are selected. Create a blog in Shopify Admin.
Article fails to publish (Error status)The API token lacks the write_content scope, or the target blog was deleted.Verify the app has the write_content scope. Check that the selected blog still exists in your Shopify store.
💡

For testing, you can create a dedicated "Drafts" blog in Shopify and select it in iContentForge. This prevents accidental publishing to your main blog while you verify the integration works as expected.

Next Steps

Shopify Integration — iContentForge Docs | iContentForge