-
General
-
Releases
-
Base Connector
-
- Beginner's Guide
- Overview
- Stations
- Datamaps
- Importing templates
- Formats
- Setting conditions
- Placeholders
- Job filter function
- How to create backups
- Running and Monitoring Jobs
- Export Job Automation
- Import/Export & copy of data map rows
- Synchronizing references that are not contained in views
- Get the preconfigured "Source data set - Template"
- Configuring categories and products
- Channel/View Tree Maintenance Active Job
- Configuring the price & stock modules
- Configuring the price/stock value ranges
- Configuring volume discounts/scale prices
- How to export prices
- How to export stock values from certain storage units
- Use of Contentserv Credentials
- Connector & Station User Limitation
- SC::Dynamic Image Crop Preset
- Todos
- Show all articles ( 11 ) Collapse Articles
-
- Price Table
- Stock Table
- Sales Channel Table
- Complex Article Table
- Importing data into SAWS tables (price, stock, etc.)
- SAWSConnector Usages
- Variant Articles
- Assignment of articles to complex articles
- Searching for SC::Prices / SC::Stocks
- Searching for SC::Channels
- Setup a transformation list for CSTypes
- Context-Sensitive Product Value Export
-
- Working with placeholder in conditions
- Improve usability of SC::Tables
- Placeholder for SC::Price, SC::Channel, SC::Stock
- REST Service API for SAWS Tables (Prices, Stock, Channels & Complex Articles)
- Dataflow import of SC::Tables
- Dataflow export of SC::Tables
- The datamap summary - Creating an automated documentation
- Export images as a ZIP file
- Image export with direct access to the CONTENTSERV platform
- Image export with no access to the CONTENTSERV platform
- Image export from a third party system
- How to configure CS Dashboard
- Setup a transformation list for CSTypes
- FAQ
- Export Smart Document via Active Script and assign output to product
- Format Macros
- Controlling Connector Jobs via the REST API
- Sales Channel Maintenance via Excel Cross-Reference
- Sales Channel Inheritance Active Job
- Job Parameters & Context Parameters
- Logbook
- Fill complex article tables automatically
- Datamap Mapping Status
- SAWS Create CS Channels via SAWS Sales Channels
- Show all articles ( 9 ) Collapse Articles
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
- Merge reference values format plugin
- Search for usage of item
- Search for item IDs using attribute data
-
- Loop Head and Loop Value
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for CS type reference
- Loop values for a CS table
- Loop value for simple data record
- Loop values for JSON Objects
- Loop for value range entries
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- AI Value Transformation Format
- AI Value Translation Format
- Store value into a Contentserv Item
- Execute a conditional format (switch-case) Format Plugin
- Load array value from the Contentserv getValues Format Plugin
- Process HTML table Format Plugin
- Replace via regex pattern format plugin
- Convert value ranges into each other
- Merge Array Format Plugin
- Export several attributes simultaneously
- Show all articles ( 5 ) Collapse Articles
-
Owl Cloud Services
-
Owl Data Hub
-
Ursula AI
- Ursula AI
- Supported AIs
- AI Value Transformation Format
- AI Value Translation Format
- Generate Descriptions with Ursula AI Active Job
- Populate Attributes via Ursula AI Active Job
- AI Product Tree Organizer Active Job
- Mapping Sales Channels via the Ursula AI Active Job
- Store value into a Contentserv Item
-
GenericJSON / DynamicJSON Connector
-
- SAWSConnector settings
- Categories
- Products
- Product-Category assignment
- Export von Feldkonfigurationen/Attribute/Wertelisten
- Finish the export
- Response log
- Sample JSONs
- SQL Transmitter
- Base. (Baselinker) Transmitter
- PlentyONE Transmitter
- Building JSON Target Keys
- Default HTTP Transmitter
- Configuratorware Transmitter
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
- Merge reference values format plugin
- Search for usage of item
- Search for item IDs using attribute data
-
- Loop Head and Loop Value
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for a CS table
- Loop values for CS type reference
- Loop value for simple data record
- Loop values for JSON Objects
- Loop for value range entries
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- AI Value Transformation Format
- AI Value Translation Format
- Store value into a Contentserv Item
- Execute a conditional format (switch-case) Format Plugin
- Load array value from the Contentserv getValues Format Plugin
- Process HTML table Format Plugin
- Response Handler Field Plugin
- Replace via regex pattern format plugin
- Convert value ranges into each other
- Merge Array Format Plugin
- Export several attributes simultaneously
- Show all articles ( 6 ) Collapse Articles
-
GenericXML Connector
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
- Merge reference values format plugin
- Search for usage of item
- Search for item IDs using attribute data
-
- Loop Head and Loop Value
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for a CS table
- Loop values for CS type reference
- Loop value for simple data record
- Loop values for JSON Objects
- Loop for value range entries
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- AI Value Transformation Format
- AI Value Translation Format
- Store value into a Contentserv Item
- Execute a conditional format (switch-case) Format Plugin
- Load array value from the Contentserv getValues Format Plugin
- Process HTML table Format Plugin
- Replace via regex pattern format plugin
- Convert value ranges into each other
- Merge Array Format Plugin
- Export several attributes simultaneously
- Show all articles ( 5 ) Collapse Articles
-
SimpleExcel Connector
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
- Merge reference values format plugin
- Search for usage of item
- Search for item IDs using attribute data
-
- Loop Head and Loop Value
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for a CS table
- Loop values for CS type reference
- Loop value for simple data record
- Loop values for JSON Objects
- Loop for value range entries
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- AI Value Transformation Format
- AI Value Translation Format
- Store value into a Contentserv Item
- Execute a conditional format (switch-case) Format Plugin
- Load array value from the Contentserv getValues Format Plugin
- Process HTML table Format Plugin
- Replace via regex pattern format plugin
- Convert value ranges into each other
- Merge Array Format Plugin
- Export several attributes simultaneously
- Show all articles ( 5 ) Collapse Articles
-
Magento Connector
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
- Merge reference values format plugin
- Search for usage of item
- Search for item IDs using attribute data
-
- Loop Head and Loop Value
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for a CS table
- Loop values for CS type reference
- Loop value for simple data record
- Loop values for JSON Objects
- Loop for value range entries
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- AI Value Transformation Format
- AI Value Translation Format
- Store value into a Contentserv Item
- Execute a conditional format (switch-case) Format Plugin
- Load array value from the Contentserv getValues Format Plugin
- Process HTML table Format Plugin
- Replace via regex pattern format plugin
- Convert value ranges into each other
- Merge Array Format Plugin
- Export several attributes simultaneously
- Show all articles ( 5 ) Collapse Articles
-
Shopware 5 Connector
-
- Configuration Shopware
- Configuration PIM
- Shopware attribute setting
- Configuration SAWSConnector
- Station configuration
- Source data set configuration
- Configuring categories and products
- Price table configuration for Shopware
- Result in Shopware
- Subshops and the SAWSConnector Shopware
- ean
- Custom Fields (attribute)
- highlight
- purchaseSteps
- stockMin
- supplierNumber
- notification
- shippingFree
- length
- height
- width
- weight
- shippingTime
- metaKeywords
- Show all articles ( 9 ) Collapse Articles
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
- Merge reference values format plugin
- Search for usage of item
- Search for item IDs using attribute data
-
- Loop Head and Loop Value
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for a CS table
- Loop values for CS type reference
- Loop value for simple data record
- Loop values for JSON Objects
- Loop for value range entries
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- AI Value Transformation Format
- AI Value Translation Format
- Store value into a Contentserv Item
- Execute a conditional format (switch-case) Format Plugin
- Load array value from the Contentserv getValues Format Plugin
- Process HTML table Format Plugin
- Replace via regex pattern format plugin
- Convert value ranges into each other
- Merge Array Format Plugin
- Export several attributes simultaneously
- Show all articles ( 5 ) Collapse Articles
-
Shopware 6 Connector
-
- Tutorial Video
- Initial Connection & Authentication
- Import Shopware settings
- Export categories
- Export media files
- Export simple products
- Export multiple languages
- Export variant products
- Export product properties
- Export custom fields
- Export product cross-selling relationships
- Export prices
- Export stocks
- Export into any other Shopware field
- How to address multiple Shopware 6 websites
- How to address different Shopware 6 Sale-Channels from one Contentserv System
- Useful Links
- Sales Channel Maintenance via Excel Cross-Reference
- Show all articles ( 3 ) Collapse Articles
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
- Merge reference values format plugin
- Search for usage of item
- Search for item IDs using attribute data
-
- Loop Head and Loop Value
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for a CS table
- Loop values for CS type reference
- Loop value for simple data record
- Loop values for JSON Objects
- Loop for value range entries
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- AI Value Transformation Format
- AI Value Translation Format
- Store value into a Contentserv Item
- Execute a conditional format (switch-case) Format Plugin
- Load array value from the Contentserv getValues Format Plugin
- Process HTML table Format Plugin
- Replace via regex pattern format plugin
- Convert value ranges into each other
- Merge Array Format Plugin
- Export several attributes simultaneously
- Show all articles ( 5 ) Collapse Articles
-
OXID Connector
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
- Merge reference values format plugin
- Search for usage of item
- Search for item IDs using attribute data
-
- Loop Head and Loop Value
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for a CS table
- Loop values for CS type reference
- Loop value for simple data record
- Loop values for JSON Objects
- Loop for value range entries
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- AI Value Transformation Format
- AI Value Translation Format
- Store value into a Contentserv Item
- Execute a conditional format (switch-case) Format Plugin
- Load array value from the Contentserv getValues Format Plugin
- Process HTML table Format Plugin
- Replace via regex pattern format plugin
- Convert value ranges into each other
- Merge Array Format Plugin
- Export several attributes simultaneously
- Show all articles ( 5 ) Collapse Articles
-
Typo3 Connector
-
-
- Send value of a PIM reference
- Loop values for CS PIM references
- Send value of a Channel (view) reference
- Loop values for CS Channel (Views) references
- Send value of a MAM reference
- Loop values for CS MAM references
- Send value of an attribute reference
- Send value of a user reference
- Loop values for user references
- Send value of a reference (deprecated)
- Merge reference values format plugin
- Search for usage of item
- Search for item IDs using attribute data
-
- Loop Head and Loop Value
- Loop values for several attributes simultaneously
- Loop values for child elements
- Loop values for CS PIM references
- Loop values for CS Channel (Views) references
- Loop values for CS MAM references
- Loop values for user references
- Loop values for SC::Prices
- Loop values for SC::Stocktable entries
- Loop values for SC::Complex products
- Loop values for a CS table
- Loop values for CS type reference
- Loop value for simple data record
- Loop values for JSON Objects
- Loop for value range entries
-
- Create a JSON-String (create an array)
- Format value lists
- Tree paths or values from tree elements
- Multistep formatting
- Send accesslevel of the object
- Send value of a job parameter
- Search for values in several attributes
- Format with PHP Code (deprecated)
- Format Macros
- Load data via REST Service
- AI Value Transformation Format
- AI Value Translation Format
- Store value into a Contentserv Item
- Execute a conditional format (switch-case) Format Plugin
- Load array value from the Contentserv getValues Format Plugin
- Process HTML table Format Plugin
- Replace via regex pattern format plugin
- Convert value ranges into each other
- Merge Array Format Plugin
- Export several attributes simultaneously
- Show all articles ( 5 ) Collapse Articles
-
Other Connectors
The Shopify Transmitter exports products, variants, collections, media, metafields, market prices, bundles and metaobject entries from Contentserv to Shopify. It talks to Shopify’s GraphQL Admin API directly: apart from your own custom app for the API access, nothing has to be installed in Shopify.
We provide a fully configured station template with the datamaps and jobs. This page covers the setup. The features are described on their own pages:
- Shopify Datamap Template: what is in the datamaps and what a project fills in
- Shopify Products, Variants and Options
- Shopify Collections
- Shopify Markets, Sales Channels and Prices
- Shopify Bundles
- Shopify Metaobject Entries
- Shopify Metafield Field Plugin and Shopify Mediaupload Field Plugin
- Shopify Troubleshooting: messages from Shopify and the transmitter, and what to do
Requirements
- A licence key for the OWL
- The Dynamic:JSON Connector installed in your system
- Version 1.22.0 or later for the current station template; the metaobject datamaps need 1.21.20 or later. On 1.21.19, see Shopify Datamap Template.
- Access to the Shopify store as its owner, to create the app (see Create the Shopify app)
Versions
Many sections of the Shopify pages name the connector version they need, e.g. Available from: 1.19.14 · 1.20.5 · 1.21.0. Each number is the first version of one release line that has the feature: here 1.19.14 or later in the 1.19 line, 1.20.5 or later in the 1.20 line, and every 1.21 version. A version of a newer line has it too. Sections without such a line work in every version of the Shopify Transmitter.
The installed version is shown on the SAWSConnector start page, top left next to the SAWS logo: Base Connector and one line per connector.
Import the station template
Open SAWSConnector > Stations > Add / edit stations.
- Select the Dynamic:JSON connector.

- Click Create new station from template.

- In the file selection, open Owl Cloud Templates (log in to OWL if it asks), select Shopify – Station V2 and click OK. The import starts right away. Shopify – Station is the previous template.

The station then contains:
- the Shopify transmitter
- the datamap Shopify Products, Variants, Collections V2 for products, variants and collections, and for deleting them
- the datamap Shopify Metaobject Entries V2 for metaobject entries
- both datamaps once more with legacy rows: the rows of earlier templates, deactivated (see Shopify Datamap Template)
- the jobs for collections, products, metaobject entries and deleted products
Every datamap row has a note with what it does, what Shopify expects and what to look out for. See Shopify Datamap Template.
Create the Shopify app
The transmitter logs in with the Client ID and the Secret of a custom app in your store. The app is created in Shopify’s Developer Dashboard.
Available from: 1.20.17 · 1.21.0
Important: the app must be created by the store owner, in the store’s own organisation. Otherwise the credentials don’t work in your store, and Shopify answers with HTTP 400:
Oauth error shop_not_permitted: Client credentials cannot be performed on this shop.
To check that the Developer Dashboard is open in the right organisation, look at the organisation switcher top right:

Create and install the app
- Open the Developer Dashboard. Depending on your Shopify version, either via Settings > Apps > Develop apps > Build apps in Dev Dashboard, or via the account menu top right: View Dev Dashboard.


- Create an app with the Create app button, give it a name and click Create.


- Select the access scopes. The app needs all scopes of the Admin API and of the Storefront API. Click Select from list next to Scopes.

In the list, choose Admin API at the top left (1) and tick every scope (2):

Then choose Storefront API (1), tick every scope there too (2), and click Done (3):

- Release the app. Click Release; a version name is optional.

- Choose the distribution. On the app’s Home, select the distribution method Custom distribution, so the app is not offered in the Shopify App Store.
- Enter your store domain (from your store’s dashboard) and click Generate link. The app can then only be installed in your store.


- Install the app. Open the generated link in a new tab, select your store if you have several, and click Install. The app then appears in your store’s left navigation.

- Copy the Client ID and the Secret. The Developer Dashboard now shows one installation of the app (refresh the page if not). Under Settings you find the Client ID and the Secret.


Connect Contentserv with the store
Store the Secret as a credential in Contentserv:

Then create an HTTP connection of the type Shopify HTTP with:
- Base URL (1): the URL of the shop,
https://<your-shop>.myshopify.com - Grant Type: Client Credentials
- Client ID (2): the app’s Client ID
- Client Secret (3): the credential with the Secret

Available from: 1.22.0. Before 1.22, the shop URL, Client ID and App Secret are fields of the transmitter itself. When you update to 1.22, the module update moves them into a connection and selects it in the transmitter.
Important:
- Use the myshopify domain. With an
admin.shopify.com/store/…address no token can be obtained, and the job fails with “Failed to obtain access token”. - Do not change the shop URL once products are in Shopify while the station cache is used: the cache is tied to the URL, and the products would be created a second time.
- The (Deprecated) Shopify Storefront API Token is only needed for the DSA data import, not for the export.
Set up the transmitter

| Setting | What to enter |
|---|---|
| (1) HTTP Connection | The Shopify HTTP connection from above. |
| (2) Shopify Custom Metafeld Id | The metafield that holds the PIM identifier, as namespace.key, e.g. custom.pimid. See PIM identifier metafield below. |
| (3) Shopify API Version | The Admin API version, e.g. 2026-04. From 1.22 you can leave it empty: the transmitter then uses the latest version it was tested with. |
| (4) Seconds until a new request is triggered when data is missing Maximum number of times missing data will be re-requested | For data Shopify has not finished processing yet, e.g. uploaded media. Higher values make the export slower. Keep both at 0 for the defaults. |
| (5) Save return IDs of the respective Shopify entities in the attributes | One row per entity (Products, Collections) with the Contentserv attribute that receives the Shopify ID. See Shopify IDs in Contentserv below. |
Important: Shopify supports each API version for at least a year, then serves the next one instead. Use a current version. The job log warns when Shopify serves a different version than the one configured (from 1.21.19) and when a request uses fields Shopify has deprecated (from 1.22.0).
Station cache
With Use Station Cache in the station settings, the transmitter keeps the Shopify IDs of products, collections and media files, so it does not have to load them from Shopify on every run. The cache entries are shown in the station; deleting them, or switching the cache off, empties the cache.

Available from: 1.21.0 (station cache). In 1.20 (from 1.20.4) the same is the checkbox “Use Proxy-Cache for Product Ids” in the transmitter.
Important: if records were changed or deleted in Shopify by hand, empty the cache before the next export.
PIM identifier metafield
The transmitter finds products and collections in Shopify by a metafield that holds their Contentserv ID. Create this metafield definition in Shopify for products and for collections (Settings > Custom data), type Single line text, with any name. We recommend custom.pimid.


Enter it as namespace.key in the transmitter setting Shopify Custom Metafeld Id. The first row of the product, collection and delete datamaps sends it with the same key:

Important:
- Without the definition, Shopify answers “Type can’t be blank”.
- Do not change the key or the values once products are in Shopify. The transmitter would no longer find them and would create them again.
Languages
Set up the languages in the datamap’s language table:
| StoreView | Language | Channel |
|---|---|---|
default | the shop’s primary language | your sales channel |
en | English | your sales channel |

default is always the shop’s primary language. For every further language, the StoreView is the Shopify language code (en, fr, de-CH, …); its values are sent as translations of products, options, metafields, collections and metaobject entries.
Important:
- The template exports nothing until the language table is filled: rows without a language are ignored, and without any row the job stops.
- Do not add a row for the primary language’s own code.
- Add and publish the languages in Shopify (Settings > Languages).

Sales channel and node mappings
The template reads the records through a SAWSConnector sales channel:
- Link the simple products and the variant heads to the sales channel, with the structure groups (collections) they belong to.
- Do not link the variants. They come with their head through the complex article table.
The node mappings route the records: products in the sales channel go to the products datamap, variants (records without their own channel entry) to the variants datamap, and structure groups to the collections datamap.

The node conditions in the screenshot:
- productsUpdateCreate: records with a sales channel entry
- variants: records without a sales channel entry of their own
- productsDelete: the records of the delete job
- collectionsUpdateCreate and collectionsDelete: structure groups only. Nodes that link a product into a group (
PdmarticleIDgreater than 0) are skipped. The demo in the screenshot also checks a record-class attribute; the template checksPdmarticleIDonly.
Important:
- Products are only exported when they are assigned to a structure group in the sales channel.
- A variant with its own sales channel entry is exported as a product of its own.
- Structure groups that contain products also show these products as nodes. The node condition of the collections datamap skips them; keep it, or every product becomes a collection.
Jobs

On an empty shop, run the jobs in this order:
- Metaobject entries, if you use linked options or metaobject references (see Shopify Metaobject Entries).
- Collections: products can only be added to existing collections.
- Products, twice: references to products, collections in the product’s list and bundle components that were created in the same run are found in the second run.
Deleting:
- Products are deleted by the job for deleted products (4), with the node mapping productsDelete.
- Collections: the datamap collectionsDelete reads the same data as the collection export, so it is deactivated. For a delete run, activate it and deactivate collectionsUpdateCreate, run the collections job, then switch both back.
Important: the transmitter only deletes what it created: products and collections with the PIM identifier metafield. Files uploaded to Shopify stay under Content > Files.
Shopify IDs in Contentserv
With the transmitter setting Save return IDs of the respective Shopify entities in the attributes, a Contentserv attribute receives the Shopify ID of each exported product and collection. Variants get their ID in the same attribute when the variants datamap sends additionalInformation, as the template does. When a product is deleted in Shopify, its ID and its variants’ IDs are cleared.
Available from: 1.19.6 · 1.20.0; variants from 1.19.8 · 1.20.0; cleared after deleting from 1.21.19
The template uses these IDs to send some values only when a product is created, e.g. the initial stock and the gift card flag.
(Deprecated) API tokens
Since 1 January 2026, Shopify no longer lets you create custom apps in the store admin. Existing apps of this kind keep working with their Admin API token: in the connection, select the Grant Type (Deprecated) Shopify Admin API Token and enter the token (before 1.22: the token field of the transmitter). New setups use an app from the Developer Dashboard, as described above.
