Frequently Asked Questions

Localization & Locale-Based Publishing

What is locale-based publishing in Hygraph?

Locale-based publishing in Hygraph allows teams to publish content for a single locale independently from other locales in a project. For example, you can publish content for Germany without affecting Switzerland, Great Britain, or Belgium. This enables teams to work flexibly, optimize workflows, and tailor content for specific audiences. Learn more.

How does locale-based publishing optimize workflows?

Locale-based publishing helps teams optimize workflows by allowing them to create, edit, and publish content for each locale independently. External translation teams can base their work on the published default locale, and teams can plan ahead by enabling future target locales in the schema and leaving them in draft until ready. This flexibility supports efficient collaboration and faster content creation. Source.

Can I publish content independently for each locale in Hygraph?

Yes, you can publish each locale independently in Hygraph, ensuring tailored content for specific markets. This allows teams to refine and test content for each locale without impacting others. Source.

How do I manage translations and localized assets in Hygraph?

Hygraph allows you to manage translations for different locales in one place. You can add, edit, and delete content per locale via the UI, and assets are localized by default. For each asset, you select which locale it applies to, starting with the default locale. If localized assets are not added, the default locale asset will be served. Learn more.

What is a default locale and fallback locale in Hygraph?

The default locale is the fallback locale used if there is not a localized version of a specific content entry. Content must first be published in the default locale before other locales can be created. The fallback locale ensures content is always available, even if a translation is missing. Documentation.

Why is localization important in a CMS?

Localization is essential for reaching a global audience, complying with local regulations, and enhancing user experience. Efficient localization allows for quick launches in new markets without replicating entire page structures, and ensures content meets language, legal, and cultural standards. Source.

What is the benefit of locale-specific roles and permissions?

Locale-specific roles and permissions in Hygraph allow you to create separate custom roles for each market, granting access only to content of a particular locale. This ensures secure and targeted content management. Learn more.

Features & Capabilities

What features does Hygraph offer?

Hygraph provides a GraphQL-native architecture, content federation, scalability, and a user-friendly interface. Key features include locale-based publishing, integrations with translation and asset management tools, robust security, and support for modern development workflows. See all features.

What integrations are available with Hygraph?

Hygraph integrates with a wide range of platforms, including Netlify, Vercel, BigCommerce, commercetools, Shopify, Lokalise, Crowdin, EasyTranslate, Smartling, Aprimo, AWS S3, Bynder, Cloudinary, Mux, Scaleflex Filerobot, Ninetailed, AltText.ai, Adminix, and Plasmic. Full list of integrations.

Does Hygraph provide an API?

Yes, Hygraph offers a powerful GraphQL API for fetching and managing content efficiently. The Mutations API allows teams to interact with project content outside the UI, including adding, updating, deleting, and publishing content. API Reference.

How does Hygraph ensure security and compliance?

Hygraph is SOC 2 Type 2 compliant, ISO 27001 certified, and GDPR compliant. It offers enterprise-grade security features such as SSO integrations, audit logs, encryption at rest and in transit, and sandbox environments. Security Features.

Pricing & Plans

What is Hygraph's pricing model?

Hygraph offers a free forever Hobby plan, a Growth plan starting at $199/month, and custom Enterprise plans. For details, visit the pricing page.

Use Cases & Benefits

Who can benefit from using Hygraph?

Hygraph is ideal for developers, IT decision-makers, content creators, project/program managers, agencies, solution partners, and technology partners. It serves modern software companies, enterprises looking to modernize, and brands aiming to scale globally, improve development velocity, or re-platform from traditional solutions. See case studies.

What business impact can customers expect from Hygraph?

Customers can expect time-saving through streamlined workflows, ease of use, faster speed-to-market, and enhanced customer experience via scalable content delivery. For example, Komax achieved 3X faster time to market, and Autoweb saw a 20% increase in website monetization. Customer stories.

What industries are represented in Hygraph's case studies?

Hygraph's case studies span food and beverage, consumer electronics, automotive, healthcare, travel and hospitality, media and publishing, eCommerce, SaaS, marketplace, education technology, and wellness and fitness. Explore case studies.

Can you share specific customer success stories?

Yes. Komax achieved 3X faster time to market, Autoweb saw a 20% increase in website monetization, Samsung improved customer engagement with a scalable platform, and Dr. Oetker enhanced their digital experience using MACH architecture. More success stories.

Pain Points & Solutions

What problems does Hygraph solve?

Hygraph addresses operational pains (reliance on developers, outdated tech stacks, conflicting global team needs, clunky content creation), financial pains (high costs, slow speed-to-market, expensive maintenance, scalability challenges), and technical pains (boilerplate code, overwhelming queries, evolving schemas, cache and OpenID integration issues). Learn more.

How does Hygraph solve pain points for different personas?

For developers, Hygraph reduces boilerplate code and streamlines query management. For content creators and project managers, it offers an intuitive interface for independent content updates. For business stakeholders, it lowers operational costs, supports scalability, and accelerates speed to market. Details.

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

KPIs include time saved on content updates, system uptime, consistency across regions, user satisfaction scores, reduction in operational costs, time to market, maintenance costs, scalability metrics, and performance during peak usage. CMS KPIs.

Technical Requirements & Documentation

Where can I find technical documentation for Hygraph?

Comprehensive technical documentation is available at Hygraph Documentation, covering building, deploying, and integrating projects.

How easy is it to get started with Hygraph?

Hygraph is designed for ease of use, even for non-technical users. You can sign up for a free account and access onboarding guides, documentation, and video tutorials. For example, Top Villas launched a new project in just 2 months. Documentation.

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

Customers praise Hygraph for its intuitive interface and ease of setup. Feedback includes comments like 'super easy to set up and use' and 'even non-technical users can start using it right away.' The UI is described as logical and user-friendly. Source.

Support & Implementation

What support is available after purchasing Hygraph?

Hygraph offers 24/7 support via chat, email, and phone. Enterprise customers receive dedicated onboarding and expert guidance. All users have access to documentation, video tutorials, and a community Slack channel. Contact Support.

What training and onboarding resources does Hygraph provide?

Hygraph provides onboarding sessions for enterprise customers, training resources such as video tutorials, documentation, webinars, and access to Customer Success Managers for expert guidance. Contact Support.

Customer Proof & Case Studies

Who are some of Hygraph's customers?

Hygraph is trusted by companies such as Sennheiser, Holidaycheck, Ancestry, Samsung, Dr. Oetker, Epic Games, Bandai Namco, Gamescom, Leo Vegas, and Clayton Homes. See customer stories.

Product Performance

How does Hygraph optimize content delivery performance?

Hygraph emphasizes rapid content distribution and responsiveness, which improves user experience, engagement, and search engine rankings. Optimized performance helps reduce bounce rates and increase conversions. Performance details.

Webinar Event: How to Avoid Personalization Tech Traps

The importance of locale based publishing

In this post, we take a look at how locale-based publishing can unlock new possibilities for reaching new audiences and shortening content creation timelines.
Emily Nielsen

Written by Emily 

Feb 25, 2021
Locale Based Publishing in Hygraph

Locale-based publishing allows teams to work more flexibly and create content for audiences as they have new capacity. In this post, we take a brief look at what exactly locale-based publishing is and how to publish content from a single locale in Hygraph.



#What is Locale Based Publishing?

In Hygraph, Locale Based Publishing allows teams using multiple locales to publish content based on just one of their locales. Teams are able to publish content for a single locale, independent from the status of the other locales in their project. For example, if you have a project with locales for Germany, Switzerland, Great Britain, and Belgium and Germany is the Default Locale, a team can start and finish creating content for Germany without having to touch the other locales. As the team has the capacity to start work on a second or third locale, this content can be saved in Draft without having to be published in the final stage. It is common that several team members create content for different locales, this allows them to work independently of their counterparts and build content that matches their timelines and team priorities.


#Importance of working with Locale Based Publishing

Optimize workflows with Locale Based Publishing

Locale Based publishing helps teams optimize their workflows and keep teams efficient. If additional locales are outsourced to external companies, they are able to see the published default locale and base their content on the default locale. Teams have the flexibility to create workflows that work for them. If they want to slowly build out pages and continually add locales, that is possible with Hygraph. If teams prefer to create a full project in one locale and then create page by page a localized version of that page, that is also possible. Teams are able to plan ahead with Locale Based Publishing. It allows them to determine which locales will be target locales in the future, enable them in the schema, and leave them in an unused draft state until they have the capacity to create content for the additional locale.



Speed up content creation

Locale-based publishing also speeds up content creation across the board. Once the first iteration of a locale is complete, the team can publish and move on to other content without having to waste time waiting for other locales to be complete. Locale-based publishing opens up possibilities from integrating with 3rd party translation services into workflows because external editors are able to work with the existing locale as a guide for translation and structure of the next locale. After the default locale is in place, teams are able to work efficiently to build additional locales and can take advantage of 3rd localization services.



Refine and Test content for different locales with Locale Based Publishing

In some cases, it may be helpful for teams to test marketing content for each locale rather than have each locale be a direct translation of the default locale. We have all seen examples where direct translations lose their meaning when they do not reach the correct audience. With locale-based publishing, teams are able to build content that will bring the most value to the intended audience. As teams iterate the content, they are able to run tests based on the localized content and continue to refine one locale’s content without impacting additional locales.



Build modern products like a modern team

Modern digital products are created by a global team for a global audience. Locale-based publishing enables teams to work efficiently, reach new audiences as their product grows, be flexible to changes in taste or capacity. If a digital product gains traction in a market that was not initially anticipated, it is easy to create localized content for the new locale once the initial localized structure is in place. Teams that plan ahead and want to avoid costly redesigns will account for localization from the beginning of the project. With locale-based publishing, teams are able to have the localized structure from the beginning of the project and wait until the team has the capacity to add additional locales. Because the content of the locales exists independently of each other, teams are flexible and their workflows the modern style of a global team.


#How to use locale based publishing with Hygraph

At Hygraph, locale-based publishing is a straightforward workflow that can be easily adapted to meet the needs of your team. For a detailed look into how to create a localized content within Hygraph, check out our blog post on handling localization in Hygraph.


Much of what can be done in the Hygraph UI can also be achieved programmatically via the Mutations API. Take a look at the developer docs to discover what can be handled programmatically and how to go about this.


To start, create a schema with a default locale and at least one other locale

Project admins are able to create, edit, and remove locales under the locales options in settings.


Locales creation.png


It is important to note that in this step they will also choose the Default Locale which will be the fallback locale. Content must first be published in the default locale before the content for other locales can be created.



Enable locales via the UI

Once teams are ready to start working with an additional locale, they can enable it in the UI. Team members can click the Create item + then on the Document Information sidebar, click the plus sign for the additional locale you wish to add.

You can also disable a locale via this button. If a locale is disabled and a content editor saves the progress, the content for the disabled locale may be lost.


Add, edit, delete content to a single locale

Content editors can add, edit, and delete content to each locale via the UI. Each field will list the different locales where content editors input content. Once you have finished adding content to a specific field, you can press the arrow to the left of the field name to collapse the field for a cleaner UI.


localized fields.png


If you are working on content for a single locale and wish to hide all other locale fields without disrupting the content, simply press the eye in the Document Information Sidebar.

Publish content to a single locale

When a team member is ready to publish content for a locale, they can just press publish. Then a popup will appear that allows them to select which locale to publish (teams can also select several).


locale based publishing.png


Teams must first publish the content on their default locales and non-localized fields will always publish the default locale as well.


A note about localized assets

Localized assets work a little bit differently than the other field types. In Hygraph, all assets are localized by default. Localized assets mean that different assets will be published based on the overall final localized frontend. (This can be especially helpful for charts and diagrams.)

To localize an asset, select within the asset picker which locale will be used for the asset. You must first start with the asset for the default locale before any other localized assets can be created.


localized assets.png


If localized assets are not added, then the fallback (default locale) asset will be served where applicable.

Locale based publishing is just one look at how workflows within the CMS can help you work more efficiently and create content as efficiently as possible. For more information on localization and the difference between localization and internationalization, check out our blog post. To have a step-by-step guide of how to work with localization in Hygraph, you can take a deep dive here. If you are a developer and want to set up localization for your project, you can follow the documentation here to help.

Frequently Asked Questions

Blog Author

Emily Nielsen

Emily Nielsen

Emily manages content and SEO at Hygraph. In her free time, she's a restaurant lover and oat milk skeptic.

Share with others

Sign up for our newsletter!

Be the first to know about releases and industry news and insights.