Shopify Integration
The Shopify integration connects Shopify Online Store content to ReachLLM's Content & CMS adapter system.
What it can do
Section titled “What it can do”After connection, ReachLLM can:
- List and read Online Store pages.
- List and read Shopify blog articles.
- Publish generated articles as Shopify blog drafts or published articles.
- Upload images into Shopify theme assets when the token has theme write permissions.
- Carry generated article images in the body and send the hero image as the Shopify article image when the Admin API accepts it.
- Update page and article HTML content.
- Read and update theme assets such as homepage templates, sections, snippets,
llms.txt.liquid, androbots.txt.liquidwhen the token includes theme permissions. - Update page and article metadata where the Shopify Admin API accepts it.
- Append schema blocks to page or article body content.
- Create or update
llms.txt.liquidat/llms.txtwhen theme permissions are available, with a legacy/pages/llms-txtfallback for limited tokens. - Create or update
robots.txt.liquidin the active theme when the token includes theme write permissions.
Shopify's homepage and theme files are managed through the active theme. ReachLLM can update Online Store pages and blog articles through this integration. It can also read and update theme assets by identifier, for example asset:templates/index.json, asset:sections/header.liquid, asset:templates/llms.txt.liquid, or asset:templates/robots.txt.liquid, when the Admin API token has theme access. For stores that manage theme code in GitHub, use the GitHub integration for pull-request review workflows.
Required permissions
Section titled “Required permissions”Create a Shopify Admin API access token with permissions for Online Store pages and blog content. The exact permission names can vary by Shopify admin version, but the token must be able to read and write pages, blogs, and articles. To let ReachLLM edit homepage/theme assets, sections, snippets, templates, /llms.txt, /robots.txt, or uploaded images used by those theme assets, also grant theme access.
How to connect
Section titled “How to connect”- Open Account > Integrations.
- Go to Content & CMS.
- Click Connect on Shopify.
- Enter the store domain, for example
your-store.myshopify.comoryour-store. - Enter the Admin API access token.
- Optionally enter the Shopify Admin API version if your store requires a version other than the ReachLLM default.
- Click Connect Shopify.
If you connect through the Composio/API-key form, the API version is a ReachLLM-only targeting hint. ReachLLM stores it with the CMS mirror so retrieval and publishing use the intended Shopify Admin API version.
ReachLLM stores the Admin API token server-side. The brand profile only keeps connection status, store metadata, and capabilities.
Agent workflow
Section titled “Agent workflow”When you ask the agent to update Shopify content, it should:
- Run
cms_get_status. - Run
cms_list_contentto find the page or article. - Run
cms_get_contentto read the current body content. - Use
cms_update_contentto update the page or article.
For pages and articles, the agent can pass draft/publish status, slug or handle, title, excerpt, and hero image URL when the Shopify Admin API accepts those fields. Use the full updated HTML body, not a diff, so Shopify receives a complete replacement for the target page or article body.
When the user asks to add or replace a picture, the agent can call cms_upload_media first. That uploads the image to Shopify theme assets and returns a public URL that can be reused in cms_update_content or sent as an article image. If theme asset upload is unavailable, article publishing falls back to the original generated image URL.
For theme assets, use cms_list_content to look for asset: IDs when theme permissions are available, then call cms_get_content and cms_update_content with that asset ID. Homepage theme edits usually target asset:templates/index.json or a section referenced by that template. Root file edits can target asset:templates/llms.txt.liquid and asset:templates/robots.txt.liquid.
Website Generator source extraction can also read Shopify theme asset picker URLs that include ?theme_asset=..., for example a selected sections/header.liquid or templates/index.json entry from the source page list. ReachLLM resolves that picker URL back to the underlying Shopify theme asset before extracting content.
For generated articles, the agent can publish to the first available Shopify blog or a configured blog ID.
Website Generator source extraction
Section titled “Website Generator source extraction”When Shopify is connected, Website Generator source discovery asks Shopify for Online Store pages, blog articles, and theme assets before using sitemap results. If you ask ReachLLM to extract or redesign a current page, the source response can come directly from Shopify and includes the platform, content ID, type, URL, title, body content, and metadata.
For normal pages and articles, the agent can update the full HTML body through the CMS adapter. For homepage or component-level changes, use the returned asset: identifiers for theme templates, sections, snippets, llms.txt.liquid, or robots.txt.liquid when the Admin API token has theme permissions.
