Frequently Asked Questions

Product Information: Remote Source Data Picker App

What is the Remote Source Data Picker app in Hygraph?

The Remote Source Data Picker is a Hygraph Marketplace app that enables editors to select data from top-level remote sources for use in remote source fields within their content. Instead of manually entering IDs for external data, editors can use this picker to search and select content in a human-readable way, streamlining the content creation process. Learn more.

How do I install and configure the Remote Source Data Picker app?

To install the app, visit the Marketplace page and select "Install the App" for your project. If you don't have a Remote Source configured, follow the Remote Source setup guide. After adding a remote source, create a top-level remote source field containing an array of data for use in the picker. Configure the picker field to display the desired data and store the correct ID for each selection.

How does the picker field work for GraphQL and REST sources?

The picker fields for GraphQL sources and REST sources have different configuration requirements. When adding a picker field, select the correct type for your project and configure the display and storage values accordingly. This ensures editors can choose from the list provided by the API, with data always in sync with the front-end API.

What are remote source fields in Hygraph?

Remote source fields in Hygraph enable data to be sourced from external third-party web services and other Hygraph fields via a custom resolver entry point. This allows projects to be enriched with external data programmatically. Learn more.

Are apps and webhooks configurations global or environment-specific in Hygraph?

Apps and webhooks in Hygraph are environment-specific. Their configuration applies on a per-environment basis, which is important to consider when working with projects that use multiple environments. Read more.

Features & Capabilities

What are the key features of the Remote Source Data Picker app?

The Remote Source Data Picker app offers editors a user-friendly interface to select data from top-level remote sources, eliminating the need to manually enter IDs. It supports both GraphQL and REST sources, keeps data in sync with the front-end API, and allows for configuration of display and storage values for each picker field.

How does Hygraph ensure data is always in sync between the picker and the API?

Because the Remote Source Data Picker uses top-level remote source fields, the data available to editors is always in sync with what's available to the front-end API. This ensures consistency and reliability in content selection and delivery.

Use Cases & Benefits

Who can benefit from using the Remote Source Data Picker app?

Editors, content managers, and teams working with external data sources in Hygraph projects benefit from the Remote Source Data Picker app. It is especially useful for organizations integrating product information from PIM systems or other external databases, allowing editors to select content easily and accurately.

What problems does the Remote Source Data Picker solve for editors?

The app solves the challenge of editors needing to know and manually enter IDs for external data. By providing a searchable, human-readable picker, it streamlines the process, reduces errors, and improves efficiency in content creation workflows.

Technical Requirements & Setup

How do I add a custom Remote Source in Hygraph?

To add a custom Remote Source, navigate to the 'Add Remote Source' screen in Hygraph and select 'Custom'. Complete the required fields: Display Name, Prefix (auto-generated), optional Description, enable debugging (disable after setup for security), and select the type (REST or GraphQL). For more details, see the documentation.

How can I query data from a remote source in Hygraph?

After configuring a remote source and adding a REST field to your model, use the API playground in your Hygraph project to query the remote field along with other fields in your model within a single GraphQL query. Learn more.

Marketplace & Integrations

Where can I find the Hygraph Marketplace?

You can explore the Hygraph Marketplace and browse available apps, integrations, and starters to extend your project's capabilities at hygraph.com/marketplace.

What is the Hygraph Marketplace?

The Hygraph Marketplace is a central hub where you can discover and install apps and integrations to extend the functionality of your Hygraph projects. It includes starters, UI extensions, and recipes for working with Hygraph alongside your favorite tools. Explore the Marketplace.

Where can I browse the available apps in the Hygraph Marketplace?

You can browse all available apps to extend your project's capabilities directly on the Marketplace Apps page.

Support & Resources

Where can I find documentation and support for the Remote Source Data Picker app?

Documentation and support for the Remote Source Data Picker app and other Hygraph features are available at hygraph.com/docs. For real-time troubleshooting, you can use the Intercom chat, join the community Slack channel, or contact Hygraph support.

What customer service and support options are available for Hygraph Marketplace apps?

Hygraph offers 24/7 support via chat, email, and phone. Customers can also access the Intercom chat for real-time troubleshooting, join the community Slack channel, and use extensive documentation and training resources. Enterprise customers receive a dedicated Customer Success Manager for personalized guidance. Learn more.

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 ensure enhanced security and compliance standards for all users. See details.

What security features are available for Hygraph apps and integrations?

Hygraph provides granular permissions, SSO integrations, audit logs, encryption at rest and in transit, regular backups, and a process for reporting security issues. Enterprise-grade compliance features include dedicated hosting, custom SLAs, and support for GDPR and CCPA regulations. Learn more.

Performance & Usability

How do customers rate the usability of Hygraph apps and the editor UI?

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

Additional Resources

Where can I find the GitHub repository for the Remote Source Data Picker app?

The GitHub repository for the Remote Source Data Picker app is available at brob/hygraph-app-datapicker-poc.

Introducing Click to Edit

Remote Source Data Picker

Give your editors the ability to pick data from Top Level Remote Sources for use in a remote source field their content

Give your editors a picker for data they need to attach to content via Remote Source fields. Instead of requiring an editor to know the proper ID for any external data, install this picker and configure each field to search through the data in a top-level remote source field and allow for editors to choose content in a human-readable way.

Install the app

Use this page to install the app in your project of choice.

If you don't already have a Remote Source. Add one following this guide. After a remote source is added, create a top-level remote source field that contains an array of data for use in the picker. Example top-level remote source field with products For example, if your remote source contains product information from your PIM system, a products top-level remote source makes sense. This would allow for an editor to choose a product on an individual document.

Add a Picker field

The picker fields for GraphQL sources work slightly differently than REST sources, so choose the correct field for your project and then configure. The interface for GraphQL picker vs. REST picker

When adding the field, you'll be asked to configure certain values to tell the picker what to display and what to store for the ID.

Configuration fields for Data Array Key, ID FIeld ID, API ID, and Title Field ID

Once these fields are added, your editors can then choose from the list provided by the API. Because this uses the top-level remote source fields, it means that the data available will always be in sync with what's available to your front-end API, as well.

Build your own app

Build your own app using our SDK and extend Hygraph functionalities according to your unique requirements.