Frequently Asked Questions

App Framework Overview & Getting Started

What is the Hygraph App Framework?

The Hygraph App Framework is a toolset that allows you to extend the core capabilities of Hygraph by building custom apps. These apps can integrate Hygraph with third-party services or add custom functionality tailored to your specific needs. You can also share your apps with other users via the Hygraph Marketplace. Learn more.

What are apps in Hygraph?

Apps are packages that extend Hygraph in various ways, enabling simpler customization and integration of your project with other tools, products, and services. Apps help you adapt Hygraph to your individual or business needs. Read more.

How do I get started with the Hygraph App Framework?

You can start by following the App Framework tutorial, which guides you through creating an app with field, sidebar, or page elements. The tutorial covers registering your app, developing your application, installation and configuration flows, and building custom elements. Start the tutorial.

Features & Capabilities

What can apps built with the Hygraph App Framework do?

Apps can extend Hygraph's out-of-the-box functionality and user interface in multiple ways. Common use cases include adding custom fields to models, customizing the content editing sidebar, triggering actions in third-party systems (such as CI builds), and creating custom page views. For inspiration, explore publicly available apps in the Hygraph Marketplace.

How does the App Framework improve flexibility compared to UI Extensions?

The App Framework allows you to group all your custom elements under one app and install them at once, simplifying the installation process. It also enables the creation of custom page views and custom functionality, which was not possible with UI Extensions. Learn about migrating from UI Extensions.

What security features does the Hygraph App Framework offer?

The App Framework includes a permissions system that allows you to control resource visibility and creation. You can specify which resources should be hidden from users and which are critical and cannot be removed once the app is uninstalled. This provides better control and security compared to previous UI Extensions. Read more.

What documentation and resources are available for building apps with the Hygraph App Framework?

Hygraph provides extensive documentation, including step-by-step tutorials for registering, developing, installing, and deleting apps. There are also guides for building field, sidebar, and page elements, API references, function documentation, constants, and example implementations. Explore the full documentation at Hygraph App Framework Docs.

What SDKs are available for developing Hygraph apps?

Hygraph offers both a React SDK (@hygraph/app-sdk-react) and a JavaScript SDK (@hygraph/app-sdk) to help developers build apps efficiently.

Security & Compliance

What security and compliance certifications does Hygraph have?

Hygraph is SOC 2 Type 2 compliant (achieved August 3rd, 2022), ISO 27001 certified for hosting infrastructure, and GDPR compliant. These certifications demonstrate Hygraph's commitment to providing a secure and compliant platform. Learn more.

How does Hygraph protect customer data?

Hygraph uses granular permissions, SSO integrations, audit logs, encryption (at rest and in transit), and regular backups to protect customer data. Enterprise-grade compliance features include dedicated hosting, custom SLAs, and support for GDPR and CCPA regulations. For transparency, Hygraph provides a process for reporting security issues and offers a security and compliance report.

Use Cases & Benefits

Who can benefit from using the Hygraph App Framework?

The App Framework is ideal for developers, product managers, and marketing teams in industries such as ecommerce, automotive, technology, food and beverage, and manufacturing. It is especially useful for organizations looking to modernize legacy tech stacks, streamline content operations, and deliver exceptional digital experiences at scale. See examples in the Marketplace.

What problems does the Hygraph App Framework solve?

The App Framework addresses operational inefficiencies (such as developer dependency for content updates), financial challenges (high operational costs, slow speed-to-market), and technical issues (complex schema evolution, integration difficulties, cache and performance bottlenecks). It enables businesses to modernize their content management systems and deliver scalable, efficient digital experiences. See related KPIs.

Can you share some customer success stories related to Hygraph?

Yes. Komax achieved a 3X faster time-to-market by managing over 20,000 product variations across 40+ markets via a single CMS. Autoweb saw a 20% increase in website monetization. Samsung improved customer engagement by 15% with a scalable member platform. Dr. Oetker enhanced their digital experience using MACH architecture. Explore more customer stories.

Technical Requirements & Implementation

How easy is it to implement and start using the Hygraph App Framework?

Hygraph provides a free API Playground and a free forever developer account, allowing teams to start immediately. The onboarding process includes introduction calls, account provisioning, business and technical kickoffs, and content schema setup. Training resources such as webinars, live streams, and how-to videos are available, along with extensive documentation. Get started here.

What support and training resources are available for developers building with the App Framework?

Developers have access to 24/7 support via chat, email, and phone, real-time troubleshooting through Intercom chat, a community Slack channel (join here), extensive documentation, webinars, live streams, and how-to videos. Enterprise customers receive a dedicated Customer Success Manager for personalized guidance. See documentation.

How does Hygraph handle maintenance, upgrades, and troubleshooting for the App Framework?

Hygraph is a cloud-based platform, so all deployment, updates, security measures, and infrastructure maintenance are managed by Hygraph. Upgrades and new features are seamlessly integrated. Troubleshooting support is available 24/7, with additional resources such as documentation and an API Playground for self-service. Enterprise customers receive dedicated support. Learn more.

Performance & Usability

How does Hygraph ensure high performance for apps and content delivery?

Hygraph offers Smart Edge Cache for enhanced performance and faster content delivery, high-performance endpoints, and practical advice for optimizing GraphQL API usage. These features are designed for reliability and speed, especially for businesses with high traffic and global audiences. Read more.

How do customers rate the usability of Hygraph?

Customers frequently praise Hygraph's editor UI for being intuitive and clear, making it easy for both technical and non-technical users. Hygraph was recognized for "Best Usability" in Summer 2023. Users appreciate the ability to integrate custom apps for content quality checks and instant feedback. Try Hygraph.

KPIs & Metrics

What KPIs and metrics are associated with the pain points Hygraph solves?

Key metrics include time saved on content updates, number of updates made without developer intervention, system uptime, speed of deployment, consistency in content across regions, user satisfaction scores, reduction in operational costs, ROI on CMS investment, time to market for new products, maintenance costs, scalability metrics, and performance during peak usage. See more on CMS KPIs.

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

#App Framework

This document helps you understand what the Hygraph App Framework is and what you can do with it. With the App Framework, you can extend the core capabilities that Hygraph offers. It gives you the possibility to create your own custom apps, and (optionally) share them with other users.

The App Framework is a toolset that allows you to build apps easily. You can use it to build apps that integrate Hygraph with third-party services, or build custom integrations tailored to your specific needs.

#What are apps?

Apps are packages that extend Hygraph in various ways. Apps allow for simpler customization and integration of your project with other tools, products and services. With apps, you can adapt Hygraph to your individual or business needs.

#What can apps do?

With apps, you can extend the out-of-the-box Hygraph functionality and User Interface in various ways. From small custom field extensions to full fledged product integrations, with the App Framework & your custom apps it becomes super easy to extend Hygraph to meet your needs.

Some common use cases are:

  • Adding custom fields to your models
  • Customizing the content editing sidebar to improve the editor experience
  • Triggering actions such as CI builds in third-party systems

For inspiration on what's possible with the App Framework, check out the publicly available apps in our Marketplace.

#Why apps?

Apps offer an improvement over the UI Extensions feature, which will eventually be deprecated. We encourage all users to migrate from UIX to apps.

Why migrate from UIX to the App Framework?

The App Framework offers more flexibility and greater security features:

#Flexibility

Creating your own app to be used in the Hygraph platform allows you to have custom fields on your setup, as well as custom functionality on your CMS. You can even group up all your custom elements under one app and install them at once, which greatly simplifies the installation process compared to UI Extensions.

It also makes it possible for you to create custom page views, which was not possible before.

#Security

Certain resources are critical for an app to work, and should therefore be hidden from users to prevent accidental removal. Our App Framework offers a permissions system, which allows better control over resources visibility as well as over creating resources on behalf of the user.

With this new permissions system you can create the app establishing which resources should be hidden from users, and also which resources are critical and can't be removed once the app is uninstalled.

#Section contents

This section offers a contents map to help you readily find what you're looking for.

#Getting started

DocumentContents
OverviewHygraph's App Framework overview.
Migrate to appsContains information on how to migrate from UI Extension to app. Includes a step-by-step example for both Field UIX and Sidebar UIX.
Register an appContains all the information you need about the app registration process.
Using app tokensContains information on how to generate app tokens for your app.
Install an appContains information on how to install an app in your Hygraph Project.
Delete an appContains information on how to delete an app you've created.

#First steps

This is our App Framework tutorial. Take the first steps into creating an app with field, sidebar, or page elements.

DocumentContents
OverviewApp Framework tutorial overview document stating what you will learn as well as the prerequisites.
Register your appContains instructions on how to register your app.
Develop your appContains instructions on how to develop an application.
Installation flowContains instructions on how to develop your app's installation flow.
Configuration flowContains instructions on how to develop your app's configuration flow.
Field elementContains instructions on how to develop a custom field element.
Sidebar elementContains instructions on how to develop a custom sidebar element.
Page elementContains instructions on how to develop a custom page element.

#Quick starters

DocumentContents
Next.jsContains instructions on how to build an app with a custom field element using our Next.js starter.

#Field elements

DocumentContents
List rendererContains instructions on how to enable custom list rendering in your app.
Table rendererContains instructions on defining how custom field values are displayed in the content table.
DeclarationContains information about field element declaration properties.
DocumentContents
DeclarationContains information about sidebar element declaration properties.

#API Reference

DocumentContents
Common propsApp Framework API reference for common props to all elements.
Field elementApp Framework API reference for field element.
Sidebar elementApp Framework API reference for sidebar element.
Additional typesApp Framework API reference for additional types. It includes model, form, locale, stage, user, dialog, and toasts.

#Functions

DocumentContents
OpenDialogOpenDialog function documentation.
ShowToastShowToast function documentation.
ToastOptionsToastOptions function documentation.
useFieldExtensionuseFieldExtension hook documentation.
useFormSidebarExtensionuseFormSidebarExtension hook documentation.
useAppuseApp hook documentation.

#Constants

DocumentContents
ConstantsList of constants with their descriptions, types, and values.

#Examples

DocumentContents
openAssetPickerContains an example that will help you use the openAssetPicker method.

#Libraries

DocumentContents
React SDKLink to our App Framework React SDK.
JavaScript SDKLink to our JavaScript SDK.