For the complete documentation index, see llms.txt. This page is also available as Markdown.

Shopify Product Catalog

Connect your Shopify product catalog to impact.com to automatically keep your product listings up-to-date. For new catalogs, connect using the impact.com Affiliate Marketing app. If you already have a custom app configured for your store, see Connect using a custom app.

Connecting with the impact.com Affiliate Marketing app is the recommended method. It uses the same app as full affiliate tracking. If you've already installed it on your store, you can skip straight to entering your Base URL below.

1

Create a catalog asset on impact.com

  1. Sign in to your impact.com account, then in the left navigation menu, select [Engage] → Content → Products → Product Catalogs.

  2. Select Create Product Catalog Asset → Retail.

  3. Next to Upload Method, select Integrated Shopping Cart Import, then from the drop-down menu, select Shopify.

  4. Next to Shopify Authentication Version, select V3 - Impact App (Recommended).

2

Install the impact.com app on your Shopify store

  1. Select Install Impact App.

    • This opens the impact.com Affiliate Marketing app listing in the Shopify App Store.

    • If you've already installed this app on your store (for example, for affiliate tracking), you don't need to reinstall it, skip to step 3.

  2. Follow the installation steps in Install the impact.com app on your Shopify store to install the app.

  3. Once installed, return to the Create Product Catalog screen in impact.com to complete the rest of the form.

3

Enter your Shopify store details

  1. Enter the Base URL of your store, including the protocol (for example, https://my-example-store.myshopify.com).

Collection ID [Optional]: expand to see instructions

Specify a Collection ID to filter your catalog by the products that are part of a Shopify collection.

  • To retrieve a Collection ID, navigate to your Shopify Admin portal, select Products → Collections → Create collection.

  • Once the collection has been saved, the Collection ID can be found in the URL of the page.

  • You may specify more than one collection by entering a comma-separated list of Collection IDs (for example "14512, 15567, 12244") into the field.

  • If this field is left blank then the entire Shopify catalog will be retrieved.

  1. Optionally, to exclude product variants from the catalog, [Toggle off] Include Product Variants.

  2. Fill out the rest of the details for your product catalog, then select Save.

Connect using a custom app (alternative)

If you already have a custom app configured for your Shopify store, you can continue using it instead of installing the impact.com affiliate marketing app.

Show custom app connection steps (V2 - clientId & clientSecret)

You'll need your Shopify catalog URL and a few specific credentials from your Shopify site. You'll generate these credentials by setting up a custom app, a straightforward process that requires zero coding or technical expertise, before entering them into impact.com.

1

Sign in to your Shopify Store Owner's account

  1. Sign in using the primary store owner's account, not a third-party developer's account.

  2. Check that your site is publicly available:

    • From the left navigation menu, select Online Store → Preferences → Password protection, and confirm that Restrict access to visitors with a password is [Toggled off].

2

Create a Custom App

Next, create a custom app in your Shopify store. The purpose of this app is to generate secure credentials that you can plug into impact.com to access the catalogs in your store.

  1. From the left navigation menu, select [Settings] → Apps.

  2. Select Develop apps.

  3. From the App development screen, select Build apps in Dev Dashboard.

    • You will be redirected to your dev dashboard.

  4. In the left navigation panel, ensure you've selected Apps.

  5. In the top-right, select Create app.

  6. Name your app, then select Create.

  7. Configure your app:

    1. Below URLs, set the App URL to any site (for example, your site or impact.com), then uncheck [Checked box] Embed app in Shopify admin.

    2. Below Access, paste the following scopes in the text box, i.e., what the app should give impact.com access to:

      read_inventory,read_product_listings,read_products
  1. Select Release:

    1. Optionally, enter a Version name like 1.0 and enter a Version message.

    2. Select Release.

3

Install the app on your Shopify store

  1. On the dev dashboard, from the left navigation bar, ensure Apps is still selected.

  2. On the Apps screen, select your app.

  3. Select Install app.

  4. On the next screen, select the store name on which to install the app.

  5. On the next screen, select Install.

    • You'll be redirected to the app URL you've entered during the app configuration.

  6. On your dev dashboard, below Installs, confirm if your app installation was successful.

4

Get your app's credentials

  1. On your dev dashboard, select your app and from the left navigation menu, select Settings.

  2. Copy your Client ID and Secret.

    • You'll use these credentials later when creating the catalog.

5

Gather your Shopify catalog URL

You'll need certain information from your Shopify store. Follow these steps to get your product catalog's URL.

Head to your Shopify store landing page and get the base URL:

  1. Navigate back to your Shopify admin account.

  2. If you manage multiple stores, select the relevant store.

  3. At the bottom of your left navigation bar, select Settings.

  4. From the Settings menu, select Domains.

  5. On the Domains screen, get your base myshopify.com URL.

    • Example: https:mystorename.myshopify.com

6

Create a catalog asset with your credentials

Next, create an asset in your impact.com account that automatically pulls in the latest version of your product catalog.

  1. Sign in to your impact.com account, then in the left navigation menu, select [Engage] → Content → Products → Product Catalogs.

  2. On the Product Catalogs screen, select Create Product Catalog Asset → Retail.

  1. Next to Upload Method, select Integrated Shopping Cart Import, then from the drop-down menu, select Shopify.

  2. Next to Shopify Authentication Version, select V2 - clientId & clientSecret.

  3. Enter your Shopify store details:

    • Base URL: Enter your Shopify product catalog URL, including the protocol (for example, https://my-example-store.myshopify.com).

    • Client ID: Enter the Shopify Client ID you located above (for example, 1234abc567890def12345abc67890def).

    • Client Secret: Enter the Shopify Client Secret you located above (for example, AbCdEfGhIjKlMnOpQrStUvWxYz1234567890FAKE).

  4. Optionally, to filter out product variants from the catalog, [Toggle off] Include Product Variants.

  5. Fill out the rest of the details for your product catalog, then select Save.

Understand Shopify Authentication Version

When creating or editing a Shopify product catalog, the Shopify Authentication Version field determines how impact.com authenticates with your Shopify store:

Version
Description

V3 - Impact App (Recommended)

Authenticates using the impact.com Affiliate Marketing app installed on your Shopify store. Recommended for all new catalogs.

V2 - Custom app

Authenticates using credentials from a custom app you create in your Shopify Dev Dashboard.

V1 - No app

Authenticates using a legacy Shopify Admin API access token.

If you already have an existing Shopify catalog, impact.com sets its Shopify Authentication Version for you automatically:

  • If an impact.com app connection was found for your store, your catalog is set to V3 - Impact App (Recommended).

  • Otherwise, your catalog keeps its existing setup: V2 - clientId & clientSecret if you were using a custom app, or V1 - Legacy access token if you were using the legacy setup.

Upgrade an existing catalog

To upgrade a V1 or V2 catalog, open it for editing and select V3 - Impact App (Recommended) from the Shopify Authentication Version drop-down menu. This unlocks the Base URL field and shows the Install Impact App button, so you can complete the installation steps described above.

Understand how Shopify fields map to impact.com

Once your Shopify catalog is connected, impact.com automatically maps your Shopify product information to the corresponding fields in your impact.com catalog asset.

Shopify field
impact.com field
Required/Recommended

Title

Name

Required

ID

Catalog Item ID

Required

Base URL

Part of the generated link

Required

Price

Current Price

Recommended

Compare at Price

Original Price

Recommended

Body HTML

Description

Recommended

Inventory Quantity

Stock Availability

Recommended

Vendor

Manufacturer

Recommended

Product Type

Category

Recommended

Images

Image URL

Recommended

Barcode

GTIN

Recommended

Troubleshooting

My products show as out of stock.

When importing your product catalog via Shopify, products may upload successfully but their availability status may appear as Out Of Stock. While partners can still find these products, any marked as Out Of Stock won't appear in your Storefront.

This issue occurs because impact.com marks any product with an inventory_quantity less than 0 as Out Of Stock.

For smaller catalogs, you can manually adjust the inventory_quantity for each product in Shopify:

  1. Log in to Shopify.

  2. Select a product that is currently showing as Out Of Stock on impact.com.

  3. Navigate to the Inventory section and select [Unchecked box] Track quantity to enable inventory tracking

  4. In the Available column, select the [Drop-down menu]. Enter a positive value to Adjust by and then select Save.

  5. Optionally, select [Checked box] Track quantity to disable this option afterwards.

If you'd rather bulk edit your inventory values, view Shopify's article on Bulk Editing Inventory.

Last updated