Frequently Asked Questions

Integration Setup & Requirements

What are the prerequisites for connecting Hygraph with BigCommerce?

To connect Hygraph with BigCommerce, you need:

Apps are environment-specific, so configuration applies per environment. For more details, see the official documentation.

How do I install the BigCommerce app in Hygraph?

To install the BigCommerce app in Hygraph:

  1. Go to the BigCommerce App page and click to install.
  2. Select the Hygraph project for installation and click Add App.
  3. Fill in your Storefront ID and API Token in the configuration section.
  4. Click Save. A notification will confirm the changes.
For step-by-step visuals, refer to the installation guide.

How do I add BigCommerce products to my Hygraph content model?

To add BigCommerce products to your Hygraph content model:

  1. Navigate to the Schema builder in Hygraph.
  2. Select the model you want to enhance.
  3. Choose the BigCommerce Product field from the sidebar.
  4. Complete the Display name; the API ID will auto-fill. Optionally, add a description and configure field options (multiple values, localization).
  5. Click Create to finalize.
For more details, see the official documentation.

How do I use BigCommerce products in my Hygraph project?

To use BigCommerce products in your Hygraph project:

  1. Go to the Content editor in Hygraph.
  2. Select the model configured with the BigCommerce Product field.
  3. Click + Create entry or edit an existing entry.
  4. In the BigCommerce product section, click Select product from BigCommerce to view available products.
  5. Select products using the checkboxes and click Add selected product.
  6. Click Save or Save & Publish as needed.
For more details, see the official documentation.

Features & Capabilities

What does the Hygraph-BigCommerce integration enable?

The Hygraph-BigCommerce integration allows you to use BigCommerce as your headless commerce solution for products and eCommerce assets. By installing the BigCommerce app, you can bring your BigCommerce products into Hygraph projects and manage them alongside other content. This enables unified content workflows, streamlined product management, and the ability to leverage Hygraph's content modeling and localization features for your eCommerce assets. Learn more.

Can I localize BigCommerce product fields in Hygraph?

Yes, when adding the BigCommerce Product field to your model in Hygraph, you can enable localization by selecting the appropriate checkbox in the Field options section. This allows you to manage product information in multiple languages, supporting global eCommerce strategies. Learn more.

Are there other headless commerce integrations available with Hygraph?

Yes, Hygraph supports integrations with other leading headless commerce platforms, including commercetools and Shopify. Detailed guides are available for each integration in the Hygraph documentation.

Technical Requirements & Troubleshooting

Where can I find more information about BigCommerce API tokens and Storefront IDs?

You can find details on BigCommerce API tokens in the BigCommerce API documentation. For Storefront IDs, refer to your BigCommerce dashboard URL as described in the Hygraph integration guide. For further technical resources, visit BigCommerce's developer documentation.

Are there any environment-specific considerations when installing the BigCommerce app in Hygraph?

Yes, apps in Hygraph are environment-specific, meaning their configuration applies per environment. If your project uses multiple environments (e.g., staging, production), you need to configure the BigCommerce app separately for each. This ensures that product data and integration settings are correctly managed across different deployment stages. Learn more.

Use Cases & Benefits

Who can benefit from the Hygraph-BigCommerce integration?

The Hygraph-BigCommerce integration is ideal for businesses and teams looking to unify their content and product management workflows. This includes eCommerce merchants, marketing teams, and developers who want to leverage headless commerce capabilities while managing content and products in a single platform. Companies aiming for omnichannel delivery, localization, and streamlined operations will find this integration especially valuable. Learn more.

What are the main benefits of integrating BigCommerce with Hygraph?

Integrating BigCommerce with Hygraph offers several benefits:

For more details, see the integration overview.

Support & Resources

Where can I find technical documentation for the Hygraph-BigCommerce integration?

You can find technical documentation for the Hygraph-BigCommerce integration on the Hygraph Docs page. For BigCommerce-specific API and developer resources, visit BigCommerce's developer documentation.

What support options are available if I encounter issues with the integration?

Hygraph offers multiple support channels, including 24/7 support via chat, email, and phone, real-time troubleshooting through Intercom chat, and a community Slack channel (join here). Extensive documentation and training resources (webinars, live streams, how-to videos) are also available. For enterprise customers, a dedicated Customer Success Manager (CSM) provides personalized guidance. Learn more.

Security & Compliance

Is the Hygraph platform secure and compliant for eCommerce integrations?

Yes, Hygraph is SOC 2 Type 2 compliant (since August 3rd, 2022), ISO 27001 certified, and GDPR compliant. The platform features granular permissions, SSO integrations, audit logs, encryption (at rest and in transit), and regular backups. These measures ensure secure and compliant management of eCommerce data. For more details, see the Hygraph security features page and the security report.

Performance & Reliability

How does Hygraph ensure high performance and reliability for eCommerce integrations?

Hygraph delivers high performance through features like Smart Edge Cache, high-performance endpoints, and robust GraphQL API performance monitoring. These capabilities ensure fast, reliable content and product delivery for eCommerce businesses with global audiences. For more details, see the performance improvements blog post.

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

#Connect your Hygraph project to BigCommerce

BigCommerce is a SaaS provider for merchants running online businesses. The company's platform includes online store creation, search engine optimization, hosting, and marketing and security for small to enterprise sized businesses.

#What you can do with the Hygraph-BigCommerce integration

With this app you can continue to use BigCommerce as your preferred headless commerce solution for products and eCommerce assets. By installing the BigCommerce app, you can bring your BigCommerce 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.

  • You must have a BigCommerce account. If you don't have one yet, you can visit their website and contact their team.

  • You must have your BigCommerce Storefront ID and API token:

    • Storefront ID: You can easily find this value in the URL of your BigCommerce dashboard between store- and .mybigcommerce.com/manage/dashboard.

    • API Token: The API Token is the Access Token in your BigCommerce dashboard. You can find it by going to Settings > API > Store-level API accounts > Create API account. Make sure you enable full permissions and save.

      After you save, a window will pop up displaying the BigCommerce API credentials, and a .txt file containing your Access token will automatically download.

#Install the BigCommerce app

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

BigCommerce installationBigCommerce installation

  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 BigCommerce section of your Hygraph project.
  2. Fill in the Storefront ID and the API Token. Click here to learn how to find this information in your BigCommerce dashboard.
  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 BigCommerce product field to your model

Add the BigCommerce Product field to your modelAdd the BigCommerce Product field to your model

  1. Navigate to the Schema builder.
  2. Select the model that you would like to add the BigCommerce Product field to.
  3. Select the BigCommerce Product 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 BigCommerce Product 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 Create button.

#Use BigCommerce in your Hygraph project

Use BigCommerce in your Hygraph projectUse BigCommerce in your Hygraph project

  1. Navigate to the Content editor.
  2. Select the default that you configured the BigCommerce Product field for.
  3. Click on the + Create entry button or, alternatively, edit an existing entry.
  4. Locate the BigCommerce product section of the screen and click on Select product from BigCommerce. As a result, a new screen will display, showing the products available in your BigCommerce store.
  5. Use the checkboxes next to the pictures to select the product you wish to add to the entry, then click on the Add selected product button.
  6. Now that the product has been added to the entry, you can click on Save or Save & Publish, as needed.

#Resources

  • Click here to access BigCommerce's documentation.
  • Click here for more information on BigCommerce GraphQL Tokens.