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 REST API (version 2025-01) to create and manage blog posts.

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.
    • Default Blog ID (Optional): If you have multiple blogs, enter the numeric Blog ID for the one you want to publish to. Leave blank to auto-select the first available blog.
  5. Click Verify Connection.

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): Set a default author name to be applied to all published articles.
  3. Configure Drip Feed (Optional): Enable the Drip Feed scheduler to automatically publish articles from your queue at a steady pace.
  4. Click Save Configuration.

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 Admin API (2025-01) to create a new article in your selected blog.
  3. The article's HTML content, title, summary, cover image, and tags are transferred.
  4. SEO fields (meta title and meta description) are written to the article via Shopify's global metafield namespace (global.title_tag and global.description_tag), which Shopify uses for search engine optimization.
  5. The article is immediately published to your Shopify blog.
  6. 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.

鈩癸笍

SEO Metafields: Shopify does not support setting SEO meta title/description as direct article fields. iContentForge writes these to the global metafield namespace automatically after publishing the article. If your theme reads from these metafields, SEO data will be applied correctly.

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 first.
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.
SEO title/description not showingTheme does not read from metafields, or metafield write failed (non-critical).Confirm your Shopify theme is configured to use global.title_tag / global.description_tag metafields. Check publishing logs for any metafield error warnings.
馃挕

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