Skip to content

Shopify Integration Overview

The Shopify integration connects 3 Clicks Cloud styles and eCommerce data to your Shopify store. It keeps product information, variants, and images aligned when your team publishes and updates styles. The sections below cover setup, field mapping, and the sync rules that govern what is sent to Shopify.

How Integration Helps You

  • Automatically update your online store with the latest product info from 3 Clicks
  • Save time by mapping fields once and letting the system handle updates
  • Ensure your e-commerce data is always accurate and up-to-date
  • Test changes in a safe development environment before going live

Key Features

Feature What It Means For You
Easy Setup Step-by-step guide to create stores and apps for integration
Field Mapping Clear tables showing how 3 Clicks data flows to Shopify
Sync Rules Built-in filters and rules to maintain data integrity
API Access Secure credentials for reliable data exchange
Why Use Integration?

Integration saves time, reduces errors, and keeps your online store current with your latest styles, prices, and images.

How It Works

  • Create a test store and custom app
  • Generate API credentials
  • Map fields and apply sync rules
  • Sync data and monitor updates

Common Scenarios

  • Syncing new styles to Shopify daily
  • Updating prices automatically when costs change in 3 Clicks
  • Adding product images from 3 Clicks to your online catalog

Next Steps

  • Follow the setup guide below
  • Review the field mappings and rules
  • Explore the API Documentation
Quick Check - Before You Start
  • You have (or can create) a Shopify development store or an existing store where you can install a custom app and access Apps > Develop apps.
  • Admin API scopes write_products and read_products are enabled on the custom app before you copy credentials.
  • You can securely share the Admin API access token (starts with shpat_) and the store URL (e.g. your-store.myshopify.com) with your 3 Clicks account manager.

Setup Guide

  1. Create a development store: (or skip to Step 2. to use an existing Store)
  2. Log in to your Shopify Dashboard.
  3. Navigate to Stores > Add store.
  4. Select Development store as the store type.
  5. Fill in the store details (e.g., name it something like "3ClicksTestStore").

  6. Create the store. Note down the store URL (e.g., your-test-store.myshopify.com).

  7. Create a custom app for API access:

  8. Log in to your store's admin panel (e.g., your-test-store.myshopify.com/admin).
  9. Go to Apps > Develop apps.
  10. Click Create an app and give it a name like "3Clicks Integration".
  11. Under Configuration, select Configure Admin API scopes.
  12. Enable the following scopes: write_products, read_products.

  13. Save the changes.

  14. Install the app and get credentials:

  15. Click Install app in the app settings.
  16. Confirm the installation. This will generate an Admin API access token.

  17. Note down:

    • API access token (starts with shpat_...)
    • Store URL (e.g., your-test-store.myshopify.com)

  18. Provide the credentials to the 3 Clicks team:

  19. Send through the account details in a secure way to 3 Clicks.
  20. Connect with your account manager to learn more.

Integration Rules and Fields

This section details the fields from 3Clicks, integration rules, how fields are mapped to Shopify, and rules applied during synchronization.

3 Clicks Fields

3Clicks Field Description/Notes Maps to Shopify
Style > Style Number Unique identifier for the style Used to fetch details; part of SKU
Style > eCommerce > Description Product description details Short: title/SKU prefix; Full: body_html; Collection: product_type/tags
eCommerce must be set to published Filter for published styles Filters sync (ecommerce_status: 'Published')
Style > eCommerce > Colours and Sizes (Enabled Only) Colour and size variants Variants (option1: colour_description, option2: size)
Separate colour size variants Split into individual variants Shopify variants
Images uploaded at the colour swatch level within eCommerce Colour-specific images Product images array
If there is no image uploaded then use the Style Preview image Fallback logic Fallback to style.image as product image
Pricing from Style > eCommerce is used Sell prices per size/colour Variant price
Currency Currency for prices Not yet mapped (assumes default)
If one price for all then use that Uniform pricing Variant price
If one price per size then use that Per-size pricing Variant price
Weight from the main Style page will need to be included Product weight Variant grams/weight
Composition Material composition Metafield custom.composition
Colour Code Code for colours Metafield custom.colour_code (per variant)
Colour Descriptions Description of colours Variant option1
Colour Family Grouping of colours Metafield custom.colour_family (per variant)
Story Product backstory Metafield custom.story
Brand Product brand Vendor and Metafield custom.brand
Season Seasonal info Metafield custom.season
Tariff Customs tariff Metafield custom.tariff
Category Product category Metafield custom.category
Sub Category Sub-category Metafield custom.sub_category
Size Scale Size scaling Metafield custom.size_scale
Size Name Name of sizes Variant option2
Type Product type Product_type
Sub Type Sub-type Metafield custom.sub_type
Gender Target gender Metafield custom.gender
Collection Collection name product_type, tags, and Metafield custom.collection
Style Custom Field > Support Custom support info Metafield (dynamic based on name)
Style Custom Field > Product Attributes Attributes Metafield (dynamic)
Style Custom Field > Fabric Fabric details Metafield (dynamic)
Style Custom Field > Movement/Suitability Usage info Metafield (dynamic)
Retail Price Retail pricing Variant compare_at_price
Weight Weight value Variant weight
Weight Unit Unit (e.g., kg) Variant weight_unit
Barcodes Product barcodes Variant barcode
SKU Codes SKU identifiers Variant SKU (generated or from codes_sku)
eCommerce > Sizes Text Selected sizes

Additional Integration Rules

  • Style > eCommerce Status = Published: Only sync styles with this status.
  • Date = Updated Today: Limit sync to styles updated on the current day.

Mapped Fields to Shopify

These are the fields currently mapped from 3Clicks to Shopify based on the sync logic: - Style Number: Used to fetch detailed product info from 3Clicks (e.g., /api-user/v1/style/ecommerce/{style_number}). - Fallback Image: Stored from initial search results and used if no images are available in detailed response. - Colour Size Price: Array containing: - Colour description (maps to Shopify variant option1). - Colour code (used in SKU). - Sizes array with size (maps to option2), sell_price (maps to variant price), and is_enabled (determines if variant is included). - Description: - Short description (maps to Shopify title and SKU prefix). - Full description (maps to body_html). - Collection (maps to product_type and tags). - Images: From colour_size_price.image_list (added to Shopify images); fallback used if empty.

Applied Sync Rules

  • Variant Skipping: Variants are skipped if they lack a valid price or if is_enabled is false.
  • Image Handling: If no images in detailed response, use fallback image from search results.
  • Product Existence Check: Search Shopify for products with matching title; update if exists, otherwise create new.
  • Default Values: Product status set to 'draft'; Variant inventory_quantity defaults to 0.
  • SKU Generation: Format: {short_description}-{colour_code}-{size}.
  • Options: Fixed as 'Color' (position 1) and 'Size' (position 2).

These rules ensure data integrity and prevent invalid products from being synced.

Note: Tags are currently used for product.tags names; metafields are implemented for many custom fields.

Troubleshooting

Why are my styles not appearing in Shopify after setup?

Integration only syncs styles whose eCommerce status is Published in 3 Clicks. Sync jobs may also be limited to styles updated today, depending on how the job is configured.

Steps to resolve:

  1. In 3 Clicks, open the style and set eCommerce Status to Published (see eCommerce status if applicable).
  2. Confirm the style has valid enabled colour/size rows with prices where required; variants without a valid price or with is_enabled false are skipped.
  3. Ask your 3 Clicks contact to confirm whether the sync filter includes only today’s updates and trigger or wait for a run that includes your style.
Why am I getting API or authentication errors from Shopify?

Invalid, revoked, or insufficiently scoped tokens cause Shopify to reject Admin API calls. The custom app must be installed and the token you supplied must match the store you configured.

Steps to resolve:

  1. In Shopify Admin, open Apps > Develop apps, select your integration app, and confirm Admin API access is installed and the token has not been rotated without updating 3 Clicks.
  2. Under Configuration, verify read_products and write_products scopes are still enabled and saved.
  3. Re-copy the Admin API access token and store URL and send them securely to 3 Clicks if the team confirms credentials need refreshing.
Why are product updates wrong or incomplete in Shopify?

Field mapping and sync rules determine what is sent. Currency from 3 Clicks is not mapped to Shopify yet (the store default is assumed). Missing weights, images, or description data in 3 Clicks flows through to weaker or incomplete Shopify products.

Steps to resolve:

  1. Compare your 3 Clicks data with the 3 Clicks Fields table and ensure Style, eCommerce descriptions, colours/sizes, pricing, and weight are filled in as documented.
  2. Upload images at the eCommerce colour level when possible; otherwise confirm a Style preview image exists for fallback.
  3. If products duplicate instead of updating, check whether the short description (title) matches what Shopify uses to find existing products, and align naming with your 3 Clicks contact if needed.