Frequently Asked Questions

Smartling App Integration & Changelog

What recent security improvements have been made to the Smartling app integration?

In February 2026, the Smartling app integration for Hygraph updated its Next.js dependency to address CVE-2025-66478, improving security for users. Note: Security updates are ongoing; detailed limitations not publicly documented—ask sales for specifics.

How does the Smartling app handle asset uploads in component translations?

As of February 2026, the Smartling app ensures that all referenced assets are uploaded during sync, even when the surrounding component has no translatable fields. Previously, asset uploads could be skipped, leaving localized assets stuck in the ASSET_CREATE_PENDING state and preventing publishing. Note: Edge cases may still exist for deeply nested assets; consult documentation for specifics.

How are string array translations managed in the Smartling app?

String arrays are now sent as single translation units and properly unwrapped when updating content, preventing issues where localized string arrays could be split into multiple Smartling segments or returned in an unexpected structure. This fix was implemented in February 2026. Note: Complex array structures may require additional review; limitations not fully documented.

How does the Smartling app handle models with acronyms in API IDs?

In February 2026, the Smartling app fixed an issue where selecting models with acronyms in their API IDs (e.g., FAQItem) could trigger a 'Failed to fetch entries' error due to incorrect field name generation. Acronym casing is now preserved so entries load correctly. Note: Models with unusual naming conventions may still require manual review.

What improvements have been made to Smartling job creation and content inclusion?

As of January 2026, submitting entries for translation now correctly includes content even if the model does not have a configured title field API ID. Previously, jobs could be empty if this field was missing. Note: Models with incomplete API configuration may still require manual setup.

How does the Smartling app ensure translations appear in Hygraph after sync?

Sync now includes id and __typename fields for component union items, ensuring translations are visible in the editor after successful sync. This fix was implemented in January 2026. Note: Custom component unions may require additional configuration.

How are localized assets handled when re-importing Smartling jobs?

Re-importing localized jobs now correctly detects and uploads nested asset references, ensuring localized images appear in all locales. Previously, assets nested inside deeply structured components were not always uploaded. Note: Deeply nested assets may still require manual verification.

How does the Smartling app handle empty asset list items during import?

Empty asset translations within list or component array fields are now skipped, preventing import errors and ensuring reliable imports. This fix was implemented in January 2026. Note: Edge cases with custom asset lists may require additional review.

What improvements have been made to Smartling exports and asset handling?

Smartling exports now include clearer section and field context, making translations easier to understand. When reuploading assets, existing localized files are retained instead of being overwritten. These improvements were released in November 2025. Note: Export limitations for custom fields may still apply.

How does the Smartling app support asset translation and rich text translation?

As of October 2025, the Smartling app supports direct asset translation and rich text translation for both basic and modular components. Updated strings pushed to existing Smartling jobs show the 'Awaiting authorization' status. Note: Rich text translation for highly customized fields may require manual review.

How does the Smartling app detect and manage stale translations?

Stale translation detection highlights outdated entries and provides filters to view All, Only Outdated, or Only Up to Date translations. Edit links for entries open in a new tab for improved workflow. Note: Detection accuracy may vary for highly customized workflows.

How does the Smartling app handle boolean fields in exports?

As of November 2024, boolean fields are no longer included in exports. Previously, exported boolean fields (true/false) were translated to strings, resulting in import failures. Note: Custom boolean handling may require additional configuration.

Features & Capabilities

What integrations does Hygraph offer besides Smartling?

Hygraph provides integrations with Digital Asset Management systems (Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, Scaleflex Filerobot), hosting platforms (Netlify, Vercel), Product Information Management (Akeneo), commerce solutions (BigCommerce), and translation/localization tools (EasyTranslate). For a complete list, visit Hygraph's Marketplace. Note: Integration capabilities may vary by plan and project type.

What APIs are available in Hygraph?

Hygraph offers multiple APIs: GraphQL Content API (optimized for high performance and low latency), Management API (for project structure), Asset Upload API (for uploading assets), and MCP Server API (for secure communication between AI assistants and Hygraph). For details, see the API Reference documentation. Note: API access may depend on project configuration and user permissions.

Security & Compliance

What security and compliance certifications does Hygraph hold?

Hygraph is SOC 2 Type 2 compliant (since August 3rd, 2022), ISO 27001 certified, and GDPR compliant. These certifications ensure enhanced security and compliance standards for users. For more details, visit Hygraph's Secure Features page. Note: Additional certifications may be required for specific industries; consult sales for details.

Implementation & Ease of Use

How long does it take to implement Hygraph and its integrations?

Implementation timelines vary by project complexity. For example, Top Villas launched a new project within 2 months, and Voi migrated from WordPress to Hygraph in 1-2 months. Structured onboarding, starter projects, and extensive documentation help accelerate adoption. Note: Highly customized integrations may require longer timelines.

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

Customers praise Hygraph's intuitive interface and accessibility for both technical and non-technical users. Sigurður G., CTO, noted the UI is intuitive enough for normal people to use. Anastasija S., Product Content Coordinator, enjoys instant visibility of changes on the front-end. Charissa K., Senior CMS Specialist, described Hygraph as "Great UI, fast to comprehend and localizeable CMS." Note: Some advanced features may require technical expertise.

Use Cases & Customer Proof

What industries are represented in Hygraph's case studies?

Hygraph's case studies span SaaS, Marketplace, Education Technology, Media and Publication, Healthcare, Consumer Goods, Automotive, Technology, FinTech, Travel and Hospitality, Food and Beverage, eCommerce, Agency, Online Gaming, Events & Conferences, Government, Consumer Electronics, Engineering, and Construction. Note: Industry-specific requirements may vary; consult sales for tailored solutions.

Can you share specific customer success stories using Hygraph?

Samsung improved customer engagement by 15% using Hygraph. Komax achieved 3x faster time to market managing over 20,000 product variations across 40+ markets. AutoWeb saw a 20% increase in website monetization. Voi scaled multilingual content across 12 countries and 10 languages. For more, visit Hygraph's case studies page. Note: Results may vary by use case and implementation.

Technical Documentation & Support

Where can I find technical documentation for Hygraph and its integrations?

Technical documentation is available at Hygraph Documentation, including API reference, schema components, getting started guides, and integration guides for platforms like Mux, Akeneo, and Auth0. Note: Documentation for custom integrations may be limited; consult support for specifics.

LLM optimization

When was this page last updated?

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

Hygraph
Docs

#Smartling app changelog

#August 2026

Improvements

  • Sort entries by when they were last updated: The Smartling view now sorts entries by most recently updated by default, so content that changed since your last translation round appears first. A SORT BY control lets you switch to least recently updated, or back to the previous ID ordering.

#July 2026

Improvements

  • Filtering by title on models with a fixed set of title values: When a model's title field is an enum, the Smartling view now shows a TITLE dropdown listing that enum's values, so those models can be filtered by title instead of offering a free-text search that might never match.
  • Warning for long-running syncs: Selecting a large number of locales for a single sync can push the import close to timing out. The sync dialog now shows a warning when an import has been running unusually long, suggesting you split the work into smaller batches.
  • Clearer message when the Content API token has expired: An expired or unauthorized Content API token previously surfaced as a generic unknown error while loading entries or running Smartling actions. The app now states that the Content API token has expired or failed authentication, so you can update it and retry.
  • Content API errors are shown instead of hidden: When the Content API rejects a request while loading entries, the app now shows what the Content API actually reported rather than a generic error.

Fixes

  • Sync failing silently for entries with many locales and rich text list fields: Syncing an entry that combined several rich text list items with many locales could generate a single oversized request that the platform rejected outright, silently dropping the whole conversion step. Large conversions are now split into smaller requests, so syncs of this size complete successfully.
  • Search by Title failing with an unknown error: On models whose title field is not a single-line text field, or that have no title field at all, searching by title returned no results and showed an UNKNOWN_ERROR message even though matching entries were visible. Title search is now offered only in the form each model supports, such as free text, a value dropdown, or not at all. Where it is not possible, the search box is disabled and the app points you to Search by ID instead; locale and locale status filters continue to work as usual.
  • Multi-value text translations lost during import: When syncing completed translations back from Smartling, fields holding a list of text values (for example, option lists or tag lists) could come back untranslated, with the translated values dropped without any warning. These list translations are now imported correctly.
  • Failed syncs reported as successful: When Hygraph rejected an entry update or a localized asset upload during import, for example because of a schema or locale mismatch, the entry was still counted as successfully synced and marked as translated. Such entries now appear in the failed-entries alert instead, so you can see and retry what actually failed.

#June 2026

Fixes

  • Copying entry IDs when clipboard access is blocked: Copying an entry ID could fail silently in embedded app contexts where browser permissions block direct clipboard writes. The app now falls back to a compatible copy method, and shows an error if copying still cannot complete.
  • Localized asset uploads for draft-only entries: Importing completed translations could update localized asset text but leave the images themselves pending, because the app looked for asset upload information outside the draft stage or reused localization state across assets in the same gallery. Asset uploads now use draft entry data and evaluate each asset separately, so translated images are re-uploaded during sync.

#April 2026

Fixes

  • Draft entries could not be submitted for translation: Submitting entries that existed only as drafts could fail before upload because the app prepared an empty Smartling batch. Draft entries can now be submitted reliably, and empty batches are no longer sent.
  • Setup screen stuck on Saving: On the app setup screen, saving could stay in a loading state indefinitely even after the configuration had been applied successfully, so there was no confirmation and a reload was needed to verify the changes. Saving now completes and confirms reliably.
  • Missing assets after import for list-based content blocks: Translated entries using list fields that contained only referenced assets could come back with those lists empty, even though the original entry had assets selected. The export and import flow now preserves direct asset references in list fields, so translated entries keep their media.

#March 2026

Fixes

  • Translations rejected for list fields containing rich text: When syncing translations back from Smartling, list fields whose items contain rich text sub-properties were sent to Hygraph with Smartling metadata still attached. Hygraph rejected the payload and the update failed without a visible error. Translation import now unwraps this nested metadata before updating the entry.

#February 2026

Improvements

  • Security - Next.js dependency updated to address CVE-2025-66478.

Fixes

  • Asset uploads skipped in certain component translations: While translating content that contained image assets inside components with no translatable text, the asset file upload was skipped. This left localized assets stuck in the ASSET_CREATE_PENDING state and prevented publishing. All referenced assets are now uploaded during sync, even when the surrounding component has no translatable fields.

  • String array translations missing or incorrect: Localized string arrays could be split into multiple Smartling segments or returned in an unexpected structure, causing translations to appear incorrectly or not at all in Hygraph. String arrays are now sent as single translation units and properly unwrapped when updating content.

  • Smartling tab error for models with acronyms in API IDs: Selecting models with acronyms in their API IDs (for example, FAQItem) could trigger a Failed to fetch entries error and a GraphQL error field 'FAQItem' is not defined due to incorrect field name generation. Acronym casing is now preserved so entries load correctly.

#January 2026

Fixes

  • Empty Smartling jobs when title field API ID was missing: Submitting entries for translation could create Smartling jobs without content if the model did not include a configured title field API ID. The app now handles this case correctly so content is always included in the translation job.

  • Translations not appearing in Hygraph after successful sync: In some cases, sync completed successfully but translations were not visible in the editor. This occurred because Smartling job files were missing id and __typename fields for component union items. These fields are now included so translations can be applied correctly.

  • Missing localized assets after re-importing Smartling jobs: Re-importing localized jobs could result in image assets appearing greyed out or missing in non-default locales. Assets nested inside deeply structured components were not always uploaded. Nested asset references are now correctly detected and uploaded so localized images appear in all locales.

  • Incorrect entry selection when switching models: Changing the selected model did not reset entry selection, which could cause the selection count or chosen entries to be incorrect. Entry selection now resets when the model changes and is tracked using entry IDs instead of indices.

  • Import failures caused by empty asset list items: Empty asset translations within list or component array fields could cause import errors. These empty entries are now skipped so imports complete reliably.

#November 2025

Improvements

  • Clear section and field context in Smartling exports: With smarter key and instruction generation, Smartling exports now include clearer section and field context, making translations easier to understand.
  • Preserved localized assets: When reuploading assets, existing localized files are retained instead of being overwritten.

Fixes

  • Complete export coverage: Entries now export with all nested components and Rich Text content included.
  • Accurate filter counts: Adjusting Smartling search filters no longer leaves behind an incorrect or stale selection count.
  • Reliable asset array handling: Empty asset arrays within component arrays no longer cause Smartling import errors.

#October 2025

Improvements

  • Asset translation support: You can translate assets directly.
  • Smartling job updates: When updated strings are pushed to an existing Smartling job, they show the Awaiting authorization status.
  • Rich text translation: Rich text fields in both basic and modular components are translated.

#September 2025

Improvements

  • Stale translation detection: Outdated entries are clearly highlighted, with filters to view All, Only Outdated, or Only Up to Date translations.
  • Enhanced navigation: Edit links for entries open in a new tab for a smooth workflow.
  • Support for modular components: Fixed issues that previously caused crashes during import or export.
  • Better error handling: Clearer messages help you troubleshoot issues faster.

#November 2024

Fixes

  • Boolean exports - Boolean fields are no longer included in exports. Previously, exported boolean fields (true/false) were translated to strings, which resulted in import failures.