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.
- Log in to your Shopify Admin dashboard.
- Navigate to Settings > Apps and sales channels.
- Click Develop apps (for Shopify Plus) or Create an app under the "Custom apps" section.
- Configure your app:
- Enter an App name (e.g., "iContentForge Blog Publisher").
- Set the App URL to
https://app.icontentforge.com.
- 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.
- Click Save.
- On the app overview page, click Install app.
- 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.
- In your iContentForge dashboard, go to your Project Settings.
- Navigate to the CMS Integration tab.
- Select Shopify from the list of available CMS platforms.
- In the connection form, enter the required details:
- Shopify Store Domain: Enter your store's
.myshopify.comdomain (e.g.,your-store.myshopify.com). Do not includehttps://. - Admin API Access Token: Paste the token you copied in Step 1.
- Shopify Store Domain: Enter your store's
- 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.
- Select Blog: Choose the target blog (e.g., "News") from the dropdown menu.
- 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.
- 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).
- 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:
- An article in your iContentForge project moves to the Ready status.
- iContentForge uses the Shopify API to create a new article draft within your selected blog.
- The article's HTML content, title, SEO title, and meta description are transferred.
- The article is immediately published to your Shopify blog (unless you are using Drip Feed, which controls the timing).
- 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
| Issue | Likely Cause | Solution |
|---|---|---|
| "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
- Learn how to automate your publishing schedule: Drip Feed Scheduler
- Understand the different article statuses: Article Statuses & Workflow
- Explore other available integrations: CMS Integrations Overview