Published on December 3, 2020
At Contentful, we believe that the use of API-first products is a significant evolution in how developers build digital experiences.
We've seen, used and doubled down on RESTful APIs ourselves but, over the last two years, we discovered that it's time to change the way developers query data. Serverless architectures and GraphQL as the transportation layer are the future. That's why we made our GraphQL API available to all pricing tiers.
We continuously improve our GraphQL API, and the querying of localized and deeply nested content just got more powerful. In case you're not following our changelog or haven’t subscribed to our developer newsletter, I want to share the latest GraphQL additions in this post.
Ready? Let's dive in!
Contentful allows you to create and handle content in different locales. These locales were reflected in our GraphQL API using the locale
argument on single entity and collection fields.
You can define which locale you want to query on a GraphQL entity level. All nested entity fields follow the locale
that is defined higher in the query. If you don't specify the locale
argument, the API follows the space-specific default locale.
Previously, it was only possible to set the desired locale on a field entity level. If you wanted to access a specific entry field in multiple locales, you had to include the same entry multiple times in your GraphQL query.
Thanks to the added locale
argument on leaf fields, you can now clean up, remove the duplicated queries and include fields of multiple locales in one resource query!
Speaking of localization, let's take a look at a blog example. Assuming you're running a magazine site that includes articles in multiple languages.
You could define a content model to include one article type with many localized fields. These fields could represent the article title, description and body text in different languages. They would most notably also include a localized author field that references other authors depending on the article's language.
If you wanted to query all blog posts written in a language by one particular author, you could use the linkedFrom
field and write a query like the following:
This query works great to receive entries in a single locale, but this approach falls short when you have a multilingual author that has written articles in different languages.
To query all incoming links from multiple locales, you had to replicate the query and define different locale
arguments on the entity level. While this works, it still isn’t great.
We solved this issue and made the querying of localized reference content easier by introducing a new allowedLocales
argument.
allowedLocales
accepts one or multiple locales for the linkedFrom
field to write more specific localized queries.
_exists
One of Contentful's strengths is that it allows you to create reusable data structures. You define the content types that your application needs with just a few button clicks.
Let's take the same example. A magazine site could include articles and authors next to landing pages that include hero images and video elements. Contentful's content structures are flexible, so it's up to you to tailor everything to your needs and what you’re building.
Members of our Slack Community pointed out the use case of querying for entries that include empty reference fields. For the blog example, it should be possible to query all entries that are not referencing any author.
We thought that this was a great idea and extended the _exists
filter possibilities. Previously, you could use _exists
filters only for leaf fields. You could, for example, query for articles that don't include a title the filter title_exists
is available. Now you can use _exists
for reference fields, too.
The _exists
filter is available for single and multi-reference fields and is now at your service to find entries that are missing essential reference links.
These three additions were only the latest changes to our GraphQL API. If you have additional feedback, please don't hesitate to provide it in our community channels. We're listening and keen to learn more about your GraphQL needs.
Stay safe, and see you soon!
Subscribe for updates
Build better digital experiences with Contentful updates direct to your inbox.