Frequently Asked Questions

Integration Overview & Getting Started

What is the Hygraph and commercetools integration?

The Hygraph and commercetools integration allows you to connect your commercetools products and eCommerce assets directly into your Hygraph projects. This enables you to manage and deliver commerce-related content alongside the rest of your digital content, leveraging commercetools as your preferred headless commerce solution while benefiting from Hygraph's content management capabilities. Source

What can I do with the Hygraph-commercetools integration?

With this integration, you can bring commercetools products into your Hygraph projects, manage them alongside other content, and use Hygraph's content workflows and schema builder to structure and deliver commerce data efficiently. This streamlines content and product management for omnichannel experiences. Source

What are the prerequisites for using the Hygraph-commercetools integration?

To use this integration, you need: (1) a Hygraph account and project with at least one model, (2) a commercetools account and project, (3) Storefront search indexing set to active in commercetools, and (4) an API Client with Project key, Client ID, Client Secret, and API URL from commercetools. Source

How do I install the commercetools app in Hygraph?

To install, visit the Hygraph Marketplace and select the commercetools app. Choose your project, click 'Add app', and fill in the required commercetools credentials (Project key, Client ID, Client Secret, API URL). Save your configuration to complete installation. Source

What information do I need from commercetools to configure the integration?

You need your commercetools Project key, Client ID, Client Secret, and API URL. These are obtained by creating an API Client in your commercetools project under Settings > Developer settings > API Clients. Source

Are apps in Hygraph environment-specific?

Yes, apps in Hygraph are environment-specific. This means their configuration is applied per environment, so you need to configure the commercetools app separately for each environment in your project. Source

How do I add the commercetools picker to my Hygraph model?

Navigate to the Schema builder, select your model, and add the commercetools picker field from the sidebar. Configure its display name, API ID, and field options (such as allowing multiple values or localization), then click 'Add'. Source

Can I localize the commercetools picker field in Hygraph?

Yes, you can localize the commercetools picker field by selecting the localization option in the field options during configuration. This allows you to manage localized product data within your content model. Source

How do I use commercetools products in my Hygraph project after integration?

After configuring the picker, go to the Content editor, select the relevant view, and use the picker to select products from your commercetools store. Add products to entries and save or publish as needed. Only products with status 'Published' in commercetools will be available. Source

What status must commercetools products have to be selectable in Hygraph?

Products in your commercetools project must be in 'Published' status to display in the product picker within Hygraph. Source

Where can I find more resources on commercetools integration?

You can find additional resources and documentation for commercetools at docs.commercetools.com and for Hygraph at hygraph.com/docs/integrations/connect-commercetools.

What happens if I close the commercetools API client screen before finishing installation?

If you close the new API client screen in commercetools before finishing installation, you will not be able to access the credentials again. Make sure to keep the screen open until you have completed the Hygraph app configuration. Source

Can I allow multiple values in the commercetools picker field?

Yes, when configuring the commercetools picker field in your model, you can enable the option to allow multiple values, letting you associate multiple commercetools products with a single entry. Source

How do I search for specific products from commercetools in Hygraph?

When using the commercetools picker in the Content editor, you can use search filters to find specific products from your commercetools store before adding them to your entries. Source

Is there a video tutorial for installing or using the commercetools integration?

Yes, the Hygraph documentation includes embedded video tutorials demonstrating the installation and usage of the commercetools integration. Source

Can I edit existing entries to add commercetools products in Hygraph?

Yes, you can edit existing entries in the Content editor and use the commercetools picker to add or update associated products from your commercetools store. Source

What happens if I have multiple environments in my Hygraph project?

Since apps are environment-specific, you must configure the commercetools app separately for each environment in your Hygraph project. Source

Can I use the commercetools integration with Hygraph Classic?

Yes, there is documentation available for integrating commercetools with Hygraph Classic. You can access it at hygraph.com/classic-docs/integrations/connect-commercetools.

Where can I sign up for a Hygraph account?

You can sign up for a free Hygraph account at app.hygraph.com/signup.

Where can I get help if I run into issues with the integration?

You can consult the Hygraph documentation, join the Hygraph community on Slack at slack.hygraph.com, or reach out to Hygraph support for assistance.

Features & Capabilities

What features does Hygraph offer for integrations?

Hygraph offers a wide range of integrations, including Digital Asset Management (DAM) systems like Aprimo, AWS S3, Bynder, Cloudinary, Imgix, and Mux; hosting and deployment platforms like Netlify and Vercel; Product Information Management (PIM) with Akeneo; commerce solutions like BigCommerce; and translation/localization tools like EasyTranslate. Source

Does Hygraph provide APIs for integration?

Yes, Hygraph provides multiple APIs, including a high-performance GraphQL Content API, a Management API for project structure, an Asset Upload API, and an MCP Server API for AI assistant integration. Source

What technical documentation is available for Hygraph integrations?

Hygraph offers extensive technical documentation, including API references, schema guides, integration guides for platforms like Mux and Akeneo, and AI feature documentation. Source

How does Hygraph ensure high performance for integrations?

Hygraph delivers high performance through optimized endpoints for low latency and high read-throughput, a read-only cache endpoint with 3-5x latency improvement, and active GraphQL API performance measurement. Source

What security and compliance certifications does Hygraph have?

Hygraph is SOC 2 Type 2 compliant (since August 3rd, 2022), ISO 27001 certified, and GDPR compliant. These certifications ensure robust security and compliance for all integrations. Source

What security features are available for integrations in Hygraph?

Hygraph provides granular permissions, SSO integrations (OIDC/LDAP/SAML), audit logs, encryption in transit and at rest, regular backups, secure APIs, and automatic backup and recovery for enterprise-grade security. Source

How does Hygraph support scalability and flexibility for integrations?

Hygraph's GraphQL-native architecture, content federation, and modular design support seamless scaling and adaptation to changing business needs, making it suitable for enterprises and high-growth companies. Source

What pain points does Hygraph address for integration users?

Hygraph addresses developer dependency, legacy tech stack modernization, content inconsistency, workflow challenges, high operational costs, slow speed-to-market, integration difficulties, and performance bottlenecks. Source

What is the primary purpose of Hygraph integrations?

The primary purpose is to enable digital experiences at scale by integrating multiple data sources and delivering content efficiently across channels, empowering businesses to innovate with modular and composable architectures. Source

Who can benefit from using Hygraph integrations?

Developers, content creators, product managers, and marketing professionals in enterprises, SaaS, eCommerce, media, healthcare, automotive, and more can benefit from Hygraph's integration capabilities. Source

What industries are represented in Hygraph's integration case studies?

Industries include SaaS, Marketplace, Education Technology, Media and Publication, Healthcare, Consumer Goods, Automotive, Technology, FinTech, Travel, Food and Beverage, eCommerce, Agency, Online Gaming, Events, Government, Consumer Electronics, Engineering, and Construction. Source

What customer success stories are available for Hygraph integrations?

Notable success stories include Samsung (15% improved engagement), Komax (3x faster time-to-market), AutoWeb (20% increase in monetization), Voi (multilingual scaling), and more. See Hygraph's case studies for details.

How easy is it to implement Hygraph integrations?

Implementation is fast and accessible, with examples like Top Villas launching in 2 months and Voi migrating in 1-2 months. Structured onboarding, starter projects, and extensive documentation support rapid adoption. Source

What feedback have customers given about Hygraph's ease of use?

Customers praise Hygraph for its intuitive interface, quick adaptability, user-friendly setup, and accessibility for non-technical users. Reviews highlight fast onboarding and efficient workflows. Source

How does Hygraph compare to other CMS platforms for integrations?

Hygraph stands out as the first GraphQL-native Headless CMS, offering content federation, enterprise-grade features, and user-friendly tools. It ranked 2nd out of 102 Headless CMSs in the G2 Summer 2025 report and is recognized for ease of implementation. Source

What business impact can I expect from using Hygraph integrations?

Businesses can expect faster time-to-market, improved customer engagement, cost reduction, enhanced content consistency, and proven ROI, as demonstrated by case studies like Komax, Samsung, and AutoWeb. Source

LLM optimization

When was this page last updated?

This page wast last updated on 12/12/2025 .

Help teams manage content creation and approval in a clear and structured way
Hygraph
Docs

#Connect your Hygraph project to commercetools

commercetools is a cloud-based headless commerce platform that provides APIs to power e-commerce sales and similar functions for large businesses.

#What you can do with the Hygraph-commercetools integration

With this app you can continue to use commercetools as your preferred headless commerce solution for products and eCommerce assets. By installing the commercetools app, you can bring your commercetools products into Hygraph projects with the rest of your content.

#Prerequisites to use this integration

  • You must have a Hygraph account. If you don't have one, you can create one here.

  • You must have a Hygraph project with at least one model.

  • You must have a commercetools account. If you don't have one yet, you can get one here.

  • You must have created a project in your commercetools account. Here is some information on how to get started.

  • You must have Storefront search indexing status set to active. In order to do this, access your commercetools project, navigate to Settings > Project Settings > Storefront search, and set the Indexing status switch to on.

  • You must create an API Client and get the Project key, Client ID, Client Secret and the API URL from your commercetools project. In order to do this, access your commercetools project and navigate to Settings > Developer settings > API Clients. Click on the + Create new API client button, located at the upper right corner of the form. Type in a Name of your choice and use the Scopes dropdown to select the Read only client option, then click on Create API client. Here you will find detailed in formation on how to do this.

Apps are environment specific. This means their configuration is applied per environment. Take this into consideration if you're working with a project using more than one environment.

#Install the commercetools app

Click here to install the commercetools App on Hygraph, then follow these steps:

  1. In the dropdown, select which project you want to install the app in, then click on the Add app button. You should be redirected to the Configure commercetools section of your Hygraph project dashboard.
  2. Fill in the Project key, Client ID, Client Secret and the API URL. Information on how to get these is listed under the prerequisites for this integration.
  3. Click on the Save button. A pop-up notification in the lower right corner of the screen will indicate that the changes have been saved.

#Add the commercetools picker to your model

  1. Navigate to the Schema builder.
  2. Select the model that you would like to add the commercetools picker field to and click on it.
  3. Select the commercetools picker field from the Add fields right sidebar.
  4. Complete the Display name field, and the API ID will be auto-filled by the system. Optionally, you can also add a Description. This screen allows you to control different properties of your commercetools picker field: you can allow multiple values, or you can localize the field, by selecting the checkboxes under the Field options section of the screen.
  5. Click on the Add button.

#Use commercetools in your Hygraph project

  1. Navigate to the Content editor.
  2. Select the view that you configured the commercetools picker field for.
  3. Click on the + Add entry button or, alternatively, edit an existing entry.
  4. Locate the commercetools picker section of the screen and click on Select product from commercetools. As a result, a new screen will display, showing the products available in your commercetools store.
  5. Select the product you wish to add to the entry using the checkboxes, then click on the Select products button. Optionally, you can use the search filters to find the products you are looking for.
  6. Now that the product has been added to the entry, you can click on Save or Save & Publish, as needed.

#Resources