Shopify Integration

Shopify powers millions of businesses worldwide and is a global commerce platform. Cozmos provides a truly unique storefront experience for your Shopify content.

This guide will walk you through how to create a private app in your Shopify store and connect your data to Cozmos.

To find out more about Shopify, visit https://www.shopify.com/

Please be aware that certain features in Shopify may be blocked depending on what plan level you have with them.

Step 1: Create a Private app

To provide all the necessary data please open your Shopify store and go to the admin page in a separate tab of your web browser. Open the “Apps and sales channels” tab which is located in the left navigation column and then click on “Develop apps” at the very top of the page.

In order to start developing apps on your store, you should allow custom app development first.

Click on “Create an app” and you will be taken to the “Create app” pop-up to enter the app related data. Please enter the information shown below in the Custom App Configuration dropdown.

Custom App Configuration

ADMIN API ACCESS SCOPES:

• Orders: Set to read_orders

• Proucts: Set to read_products

• Script Tags: Set write_script_tags and read_script_tags

• Shop Locale: Set to read_locales

• Translations: Set to read_translations

• Legal policies: Set to read_legal_policies

• Publications: Set to read_publications

STOREFRONT API ACCESS SCOPES:

• Read and modify checkouts

• Read the inventory of products and their variants

• Read and modify customer details

• Read product variants and collections

• Checkout: Set unauthenticated_write_checkouts and unauthenticated_read_checkouts

• Content: Disable unauthenticated_read_content

• Customers: Set unauthenticated_write_customers and unauthenticated_read_customers

• Products: Set unauthenticated_read_product_listings and authenticated_read_product_inventory

Please, make sure to install the app at the API credentials tab of the App development page of Shopify Store Custom App as soon as you configure and save API access scopes.

By doing that you will additionally receive Admin API access token & Storefront API access token required for your Shopify Store connection to your Cozmos account.

Make sure your products include your App as "Sales channel" for Checkout to work correctly.

Once the Custom app has been successfully created and API credentials have been received, please proceed to filling in the data to connect your Shopify store to your Cozmos account as provided below.

Step 2: Connect your Shopify store in Cozmos

To find the Shopify integration setup, go to: Settings / Ecommerce Providers / Shopify

Add your store name

You can copy this from your Shopify store URL or from the URL provided in your Shopify admin settings side menu.

Add your API Key

This info you can copy at the API credentials tab of App development page of Shopify Store Custom App, at the bottom of the page. Please, see the screenshot below.

Add your API secret key

This info you can copy at the API credentials tab of App development page of Shopify Store Custom App, at the bottom of the page, right under API key. Please, see the screenshot below.

Add your API access token

First click “Install app” at the API credentials tab of App development page of Shopify Store Custom App to get your Admin API and Storefront API access tokens.

Please be aware you may reveal the token only once. Make sure you copy and save your API secret key in a secure place.

Add your Storefront API access token

This info you can copy at the API credentials tab of App development page of Shopify Store Custom App, namely in the Storefront API access token block. Please, see the screenshot below.

Save Changes

Once all information has been added, please click on the 'save changes' button.

If all details entered are correct, you will now see a Connected status indicator next to the Shopify store name input field

If you are unable to connect your store, please reach out to our Product Support Team and we will assist where possible.

Step 3: Sync and Settings

Once connected, you have two additional settings to complete before you sync your products

1. Localised Content Data

This refers to any language data you have in your Shopify store, please ensure you select all languages you want to be available within your Sphere

2. Order Confirmation Redirect

Customers will be automatically redirected to Sphere upon completion of order. Adjust how you would like this to behave using the options provided.

Sync Products

You are now ready to sync your products. How long the sync process takes will depend on how many products you have in Shopify

While the sync is in progress, you will see products appearing in the Products section of your Space. Wait until the sync is complete before you start to edit or use any products in your Sphere design.

Step 4: Multipass (optional)

Below the Sync Your Products block you will see an option to to turn on Multipass, for a full overview of what this means, please read our Multipass Guide.