Skip to main content
Remark’s Shopify integration connects your store catalog and order data to Remark. Once connected, Remark can sync products for recommendations, track storefront behavior, and let agents use Shopify actions when an intent allows them.

​
What the integration does

After Shopify is connected, Remark can:
  • Import products, variants, images, prices, and inventory from Shopify
  • Keep new products and inventory updated, and re-import your full catalog daily
  • Attribute Shopify checkouts and orders to Remark conversations through Remark’s conversion pixel
  • Use Shopify order and customer data in approved agent actions
  • Create single-use Shopify discount codes when the discount actions are enabled
The Shopify integration is separate from the storefront SDK setup. Use the Getting Started guide for shopper event tracking and other ways to add the Remark widget.

​
Connect Shopify

You need the Integrations & products permission in Remark and permission to install apps in Shopify. This connection uses Shopify authorization. You don’t need to create an API key or copy an access token.
  1. Open Settings > Integrations in the Remark dashboard.
  2. Under Ecommerce platforms, find Shopify and select Connect. This section appears only while your workspace has no ecommerce integration.
  3. In Store domain, enter your Shopify store domain, then select Connect to Shopify.
  4. Approve the Remark app in Shopify.
  5. Back in Remark, on Let’s get you set up!, choose your workspace under Select a workspace if you belong to more than one, then select Connect to Shopify. You need permission to edit integrations in that workspace.
  6. On How to enable Remark Chat, follow the steps to turn on the Remark app embed in your Shopify theme, then select Go to Dashboard →. If your workspace is billed through Shopify, select Select a Plan → instead.
You can enter either your customer-facing domain or your .myshopify.com domain. If Remark cannot resolve the customer-facing domain to a Shopify store, use the .myshopify.com domain directly, such as:
The .myshopify.com domain identifies your Shopify store. It can differ from the customer-facing storefront domain used in Primary domain below. Don’t enter an admin.shopify.com URL.

​
Store setup

When you connect through the Remark app, Remark:
  • Imports your products
  • Sets Primary domain to your Shopify primary domain
  • Adds Remark’s conversion pixel to your store, so Remark can attribute checkouts and orders to conversations
The chat loads through the Remark app embed, which you turn on in your Shopify theme editor in step 6. If Remark connected your store with custom-app credentials instead of the Remark app, Remark adds its storefront script tag and Shopify webhooks rather than the app embed and conversion pixel. To track orders for these stores, see Conversions are missing.

​
Dashboard settings

You can manage these Shopify settings from the integration in the Remark dashboard.

​
Product sync

Remark imports Shopify products into the Remark product catalog used by agents and recommendations. Product sync includes:
  • Product title, brand, description, handle, and URL
  • Product images
  • Variants, SKUs, barcodes, selected options, prices, and compare-at prices
  • Inventory when inventory sync is enabled
  • Shopify product tags
Products can be archived in Remark when they are archived in Shopify, unpublished according to Shopify status, filtered by internal sync settings, or tagged with a value from Archive products with tags. Products with the Shopify Unlisted status are also excluded when Treat unlisted products as unpublished is enabled. The Primary domain setting affects every product link Remark builds. Use your storefront domain here when shoppers should see links like https://www.example.com/products/product-handle instead of the Shopify admin or .myshopify.com domain. Shopify notifies Remark of new products and inventory changes. Remark re-imports your full catalog every day to pick up product edits and archive products removed from Shopify. To apply changes to Archive products with tags, Treat unlisted products as unpublished, or Primary domain right away, select Import products on the Products page.

​
Add Shopify actions to an intent

Connecting Shopify makes Shopify actions available to your workspace. To let agents use them in conversations, add the relevant action to an intent. Available actions depend on the Shopify permissions granted during OAuth. Remark checks your granted permissions automatically before each product import. If an action is still missing, contact support@remark.ai.

​
Supported actions

​
Search Shopify orders

Agents can search Shopify orders to answer questions about order status, items, fulfillment, tracking, totals, refunds, and shipping or billing addresses. Order and fulfillment dates use your workspace’s time zone. Remark requires one of these for privacy:
  • A verified email address
  • The shopper’s last name plus their email address, order number, or confirmation number

​
Look up Shopify customer

Agents can retrieve a Shopify customer profile after the shopper provides a verified email address, or at least two of:
  • Email address
  • Last name
  • Phone number
The result can include customer tags, marketing consent, lifetime spend, predicted spend tier, default address, and recent orders.

​
Cancel Shopify order

Agents can cancel an open Shopify order when the action is allowed by the intent and Shopify permissions. The action:
  • Finds the order using a verified email address, or last name plus email or order number. If multiple orders match, the agent asks for the order number.
  • Rejects already closed or canceled orders
  • Enforces the configured Order change window (minutes) when one is set
  • Rejects orders with any configured Order cancellation blocking tags
  • Sends the Shopify cancellation with refund, restock, customer notification, and a customer-request staff note
In playground chats, Remark reports what would happen but does not cancel the order in Shopify.

​
Update Shopify order address

Agents can update the shipping address on an open Shopify order. The action requires a verified email address, or last name plus email or order number, along with the new shipping address fields. If multiple orders match, the agent asks for the order number. It enforces the configured Order change window (minutes) when one is set. Order cancellation blocking tags do not block address updates. In playground chats, Remark reports what would happen but does not update the order in Shopify.

​
Create discount codes

Agents can create one-time-use Shopify discount codes with the Create Shopify percentage discount and Create Shopify fixed amount discount actions. Remark supports:
  • Percentage discounts from 1 to 100 percent
  • Fixed amount discounts from $1 to $100
  • Store-wide discounts
  • Discounts scoped to a Shopify collection
  • Expiration dates from 1 to 365 days
Discount values are whole numbers. The generated code activates immediately, can be used once, doesn’t combine with other discounts, and is tagged Remark in Shopify. To control the code format, set the action’s code field to a Pattern on the intent. {{COLOR}} inserts a random color, {{ANIMAL}} inserts a random animal, {{value}} inserts the discount value, and each # inserts a random letter or number. A pattern must include #, {{COLOR}}, or {{ANIMAL}} so that each code is unique. In playground chats, Remark reports the code it would create but does not create it in Shopify.

​
Troubleshooting

​
Store domain cannot be resolved

Use the store’s .myshopify.com domain. Remark can often resolve a customer-facing domain, but custom DNS, redirects, or storefront protections can prevent resolution.

​
OAuth fails or returns to the wrong place

Start the connection again from Settings > Integrations. Shopify install links are short-lived. If the issue repeats, confirm you are logged into the correct Shopify store and have permission to approve apps.

​
Products are missing in Remark

Product import runs after connection and may take time on large catalogs. Also check whether the product is unpublished, archived in Shopify, filtered by internal sync settings, or tagged with a value in Archive products with tags.

​
Conversions are missing

Remark records Shopify orders through its conversion pixel, so orders placed while the pixel isn’t installed don’t appear as conversions. Stores connected through the Remark app get the pixel when they connect. If Remark connected your store with custom-app credentials, contact support@remark.ai to confirm the custom pixel is installed. If Remark needs collaborator access to install it, ask your Shopify administrator to assign View customer events and Manage and add custom pixels to Remark’s collaborator role. See Shopify’s collaborator account guide and store permissions. Set Primary domain to your customer-facing storefront domain and save the Shopify integration settings.

​
Orders or customers are not found

Confirm the shopper provided the identifiers required by the action. Order search needs a verified email address, or last name plus email or order number. Customer lookup needs a verified email address, or at least two of email, last name, and phone. Shopify limits order access to the last 60 days unless the app has read_all_orders alongside read_orders or write_orders. See Shopify’s order access requirements. If older orders are missing, contact support@remark.ai to check the app’s granted access.

​
A Shopify action is missing

The available Shopify actions depend on granted Shopify access scopes. Order search is available with read_orders or read_all_orders. Customer lookup also needs read_customers and read_products. Cancellation and shipping address updates require write_orders, and discount creation requires write_discounts. Remark checks your granted permissions automatically before each product import. If an action is still missing, contact support@remark.ai. Don’t create a separate custom app to add permissions to an OAuth connection.

​
Cancel order or address update fails

Check whether the order is closed, canceled, older than the configured Order change window (minutes), or ambiguous because multiple orders match. For cancellations, also check whether the order has a configured blocking tag.
Need help connecting Shopify, checking permissions, or testing actions? Contact support@remark.ai.