Frequently Asked Questions

Using Filters in Hygraph

What are filters in Hygraph and why should I use them?

Filters in Hygraph allow you to restrict the content shown in your content views by specific parameters, making it easier to curate and manage large sets of content. They help you quickly find, review, and act on content that matches certain criteria, such as author, publication stage, or custom fields. This is especially useful for editors and teams managing complex content workflows. Learn more.

What types of filters are available in Hygraph?

Hygraph offers several types of filters: Quick Filters (predefined, one-click filters for common use cases), Column Filters (filter by system or custom fields, stage, or ID), and manual filters (customize filters using various conditions and values). You can also filter by relations, content stage, and multi-value fields. See the full guide.

How do I add and use Quick Filters in Hygraph?

To add a Quick Filter, open the Filter menu in your content view, select from the available predefined options, and the filter will be instantly applied. You can add multiple Quick Filters by repeating this process. Quick Filters are available in both content and asset views, and you can further edit them if needed. Read more.

What are column filters and how do they work?

Column filters allow you to filter content by specific system or custom fields, such as stage or ID. To use a column filter, select the field, choose a condition (e.g., is, contains, less than), and enter a value if required. Column filters function similarly to Quick Filters but offer more customization. Learn more.

How can I adjust filters manually in Hygraph?

To adjust filters manually, use the filter bar at the top of the content table. Click the Filter button, select a field, choose a condition, and enter a value if needed. You can add multiple filters and remove them by clicking the X next to each filter. Manual adjustments allow for precise control over your content views. See details.

What are the available filter conditions in Hygraph?

Hygraph supports a variety of filter conditions, including: is, is not, is null, is not null, less than, less than or equal to, greater than, greater than or equal to, contains, doesn't contain, starts with, doesn't start with, ends with, doesn't end with, includes some, includes all, and includes none. These conditions allow for flexible and powerful filtering. See the full list.

Are there any limitations to filtering in Hygraph?

Yes, Hygraph does not currently support filtering for Rich Text (even inside components), JSON, multi-value fields, colors, or coordinates. Additionally, you cannot filter by union-type reference fields (fields that reference more than one model). Read more.

How do I filter content by relations or reference fields?

To filter by a reference field, click the Filter button, select the reference field from the column filters list, choose a condition, and provide the necessary value. Note that you cannot filter by union-type reference fields. Default reference filters include 'Created by', 'Updated by', and 'Published by'. Learn more.

How do I filter content by stage in Hygraph?

To filter by content stage, click the Filter button, select 'Stage' from the column filters list, and use the dropdown menus to select a condition and stage. Default stages include DRAFT, PUBLISHED, and PUBLISHED (!), with additional stages available in Growth and Enterprise plans. See more.

How do I remove a filter in Hygraph?

To remove a filter, simply click the X button next to the filter in the filter bar. This will immediately update your content view to remove the filtered results. Details here.

Features & Capabilities

What are the key capabilities and benefits of Hygraph?

Hygraph is a GraphQL-native Headless CMS that empowers businesses to build, manage, and deliver digital experiences at scale. Key benefits include operational efficiency (eliminating developer dependency, streamlining workflows), financial advantages (reducing costs, accelerating speed-to-market), technical strengths (GraphQL-native architecture, content federation, enterprise-grade security), and unique features like Smart Edge Cache, custom roles, and project backups. Explore more.

Does Hygraph support advanced content management features like localization and asset management?

Yes, Hygraph offers advanced features such as localization for global content delivery and robust asset management capabilities. These features help teams manage content efficiently across multiple regions and channels. Learn more.

Security & Compliance

What security and compliance certifications does Hygraph have?

Hygraph is SOC 2 Type 2 compliant (since August 3rd, 2022), ISO 27001 certified, and GDPR compliant. These certifications demonstrate Hygraph's commitment to providing a secure and compliant platform for its users. See details.

What security features does Hygraph offer?

Hygraph provides granular permissions, SSO integrations, audit logs, encryption (at rest and in transit), regular backups, and enterprise-grade compliance features such as dedicated hosting and custom SLAs. Learn more.

Performance & Usability

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

Hygraph delivers high performance through features like Smart Edge Cache for faster content delivery, high-performance endpoints, and optimized GraphQL API performance. These features are designed to support high-traffic, global audiences and ensure reliability and speed. Read more.

Is Hygraph easy to use for non-technical users?

Yes, Hygraph is frequently praised for its intuitive user interface, making it accessible for both technical and non-technical users. Customers highlight its ease of setup and use, and Hygraph was recognized for "Best Usability" in Summer 2023. Try Hygraph.

Support & Implementation

What support and training resources are available for Hygraph users?

Hygraph offers 24/7 support via chat, email, and phone, an Intercom chat for real-time help, a community Slack channel, extensive documentation, webinars, live streams, and how-to videos. Enterprise customers receive a dedicated Customer Success Manager and a structured onboarding process. See documentation.

How long does it take to implement Hygraph?

Implementation time varies by project scope. For example, Top Villas launched a new project within 2 months, and Si Vale met aggressive deadlines during their initial implementation. Hygraph's free API playground and developer account allow teams to start immediately, and the structured onboarding process ensures a smooth start. See case study.

Use Cases & Customer Success

Who can benefit from using Hygraph?

Hygraph is ideal for developers, product managers, and marketing teams in industries such as ecommerce, automotive, technology, food and beverage, and manufacturing. It's especially valuable for organizations modernizing legacy tech stacks, managing global content, or requiring localization and asset management. Learn more.

Can you share some customer success stories with Hygraph?

Yes. Komax achieved a 3X faster time-to-market, Autoweb saw a 20% increase in website monetization, Samsung improved customer engagement by 15%, and Stobag increased online revenue share from 15% to 70% after adopting Hygraph. See more customer stories.

Pain Points & Solutions

What common pain points does Hygraph solve for its users?

Hygraph addresses operational inefficiencies (reducing developer dependency, modernizing legacy tech stacks, ensuring content consistency), financial challenges (lowering operational costs, accelerating speed-to-market, supporting scalability), and technical issues (simplifying schema evolution, resolving integration difficulties, optimizing performance, and improving localization and asset management). See more.

How does Hygraph differentiate itself from other CMS platforms?

Hygraph stands out as the first GraphQL-native Headless CMS, offering content federation, a user-friendly interface, Smart Edge Cache, and enterprise-grade features. Its approach enables flexibility, scalability, and integration capabilities that address modern content management needs, setting it apart from competitors like Sanity, Prismic, and Contentful. Learn more.

Technical Requirements & Documentation

Where can I find more information about using filters and other Hygraph features?

You can find detailed guides and tutorials in the Hygraph Documentation, including developer guides on using filters, content workflows, roles and permissions, and more. For API-specific filtering, see the API Reference.

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

#Using filters

#Overview

Filtering allows you to restrict the content shown by specific parameters. This is helpful when trying to create a more curated overview of content.

These filters can be useful when building content views, looking for a specific type of content, or finding content that matches several parameters, such as "Created by a certain user & Stage published".

#Quick Filters

Our Quick Filters feature reduces the time and effort required to create a filter. Editors can now find the content they need, faster.

Quick FiltersQuick Filters

It offers several predefined filters that apply instantly when selected, allowing editors to focus on their work without unnecessary distractions.

To add Quick Filters, simply use the Filter menu to display the available options and select one.

Add a Quick FilterAdd a Quick Filter

Once you select a Quick Filter, the regular filter appears in the filter bar and the content table is sorted accordingly.

You can apply more than one Quick Filter. To do this, simply use the filter menu again and select another one.

For instance, the following image shows a content table where two Quick Filters have been applied, Created by me & Only published entries:

Quick Filter appliedQuick Filter applied

#Column filters

The Filter menu also contains column filters.

Column filtersColumn filters

Column filters allow you to filter content by some system and custom fields, stage and ID.

Quick and column filters function in the same way. The following document section explains how to use them.

#Adjust filters manually

You can find the filters on any content view, at the top of the content table. If there are no filters added, this is how it will look like:

Filter BarFilter Bar

To apply filters:

  1. Navigate to the Content Editor & select a view from the collapsible sidebar.
  2. Click the Filter button at the top of the content table.
  3. Select one of the fields listed for filtering. It can be a quick or column filter.
    • If you selected a quick filter, the results will show on the table below.
    • If you selected a column filter, you need to configure it:

For example, the following image shows that we have selected to filter by ID, then selected the condition contains, and finally we typed "002" in the input. As a result, the filter shows all entries that have an ID containing 002:

Filter exampleFilter example

To remove a filter, simply click the X button next to it.

Remove filterRemove filter

#Filtering by entry

After applying a quick or column filter, the results will display on the table below. The following example shows the Created By filter applied:

"Created By" filter applied"Created By" filter applied

You can adjust these filters manually by using the input fields or dropdown menus, and you can add additional filters by clicking on the filter icon.

Apply a FilterApply a Filter

Additionally, you can also filter by fields that allow multiple values. Here's an example showing an enumeration field for product size:

Multi-value enum filteringMulti-value enum filtering

#Filtering by relations

To filter your content entries by a reference field, click the Filter button and select the reference field from the column filters list.

To configure the filter:

  1. Select the field of this model that you want to use.
  2. Select a condition from the dropdown menu.
  3. Some conditions will require that you type in some data to filter by, such as a name or a slug. Updated At and Created At require that you select a date from a calendar and type in a time. Is null and Is not null do not require any additional input.

The following example filtering condition shows all of the content entries where the "Other products" reference field links to entries with a Slug that contains tote.

Filtering by relationsFiltering by relations

#Filtering by content stage

To filter content by stage, click the Filter button at the top of the content table, and select Stage from the column filters list.

After this, use the dropdown menus to select a condition and stage.

Filtering by content stageFiltering by content stage

#Stages and conditions

While there are three default stages - DRAFT, PUBLISHED, and PUBLISHED (!) - stages other than the default ones can exist in the projects of Growth and Enterprise plans.

Stage NameDefinition
DRAFTContent entries that exist in DRAFT, and don't exist in any other stage. This content has never been published.
PUBLISHEDContent entries that exist in PUBLISHED and are not outdated. This means that the published version of this content is also the latest version on the system.
PUBLISHED (!)Content entries that exist in PUBLISHED but are outdated. This means there is a version of this document currently published, but there is also another more recent version in the system.
ConditionDefinition
isSelect this condition to fetch content entries that only exist in the selected stage.
is notSelect this condition to fetch content entries that do not exist in the selected stage, and only exist in one stage.
containsSelect this condition to fetch content entries that exist in the selected stage, irrespective of also existing in other stages. This condition will only display for projects with more than two stages.
doesn't containSelect this condition to fetch content entries that don't exist in the selected stage, irrespective of also existing in other stages. This condition will only display for projects with more than two stages.

#Filtering conditions

The following list explains basic conditions and what they do:

OptionDescription
IsExact match
Is NullMatches empty (without content)
Is Not NullMatches not null (with any content added)
Is NotExclusion match
Less Thanfor numeric fields (including date and dateTime)
Less Than or Equal Tofor numeric fields (including date and dateTime)
Greater Thanfor numeric fields (including date and dateTime)
Greater Than or Equal Tofor numeric fields (including date and dateTime)
ContainsString search
Doesn't ContainExclusion by string search
Starts WithStarting string match
Doesn't Start WithExclusion by starting string match
Ends WithEnding string match
Doesn't End WithExclusion by ending string match
Includes somefor multi-value fields, some of the provided values match
Includes allfor multi-value fields, all of the provided values match
Includes nonefor multi-value fields, none of the provided values match