2.0.4 • Public • Published

DatoCMS Commerce Layer plugin

A plugin that allows users to search and select Commerce Layer SKUs.

App credentials (Commerce Layer)

To use this plugin first you need to create a Commerce Layer OAuth application and take note of its credentials. If you don't have a Commerce Layer account you can sign up for free here and follow the onboarding tutorial to create an organization and seed it with test data. Once successfully signed in to the Commerce Layer admin dashboard, go into your organization's Integrations section and create a new integration app with role Read only:

New application

Now you can access the application's base endpoint, client ID, and client secret:

Application credentials

BACKWARD COMPATIBILITY — Please note that if you are upgrading from a previous version (older than v2.0.0) you need to change your plugin settings to use an integration app because old datocms Commerce Layer apps have been dismissed and don't work with the new versions of the plugin.

Plugin configuration (DatoCMS)

You can search the plugin from the DatoCMS admin dashboard or install it from the marketplace. Once installed, you need to configure the plugin with the credentials you get from Commerce Layer app you previously created:

Plugin settings

You can either hook this plugin manually to your single-line fields, or specify an identifier and use it to create an automatic match rule (e.g. via regex).


To use the plugin you need to add a single-line text field to your model in DatoCMS and select Commerce Layer SKU from the dropdown menu in the Presentation tab:

Field type Field settings Field presentation

Now you can browse your Commerce Layer organization SKUs, search and select them from the UI. You can also create and add new SKUs by clicking the button that redirects to Commerce Layer admin dashboard:

SKU search SKU selection

The selected SKU's main information will then show in the related record:

SKU visualization

Package Sidebar


npm i datocms-plugin-commercelayer

Weekly Downloads






Unpacked Size

3.7 MB

Total Files


Last publish


  • acasazza