Custom external references

The Custom external references feature (formerly known as Third party orchestration) enables you to resolve content referenced from any third party system using the Contentful GraphQL API.

Some of our marketplace apps already support Custom external references out-of-the-box, such as Shopify, commercetools and Cloudinary. For those that don’t, you can create your own app with Functions to enable the Custom external references capability.

Functions

Functions connect to external systems, fetch additional content and enrich the response of the GraphQL request. With functions, you can use the _data suffix in your GraphQL query and stitch remote schemas together with your Contentful schema. The _data prefix can be used only when the field is annotated to be resolved in delivery with an app. Once you enable the Resolve content on delivery checkbox on your field settings and configure your field with a custom app, you can resolve remote content using the GraphQL API.

If your function has an error caused by the remote schema, query or response, you will receive an UNRESOLVABLE_RESOURCE_LINK error. If the schema generation was not successful, the _data suffixed field will be of type Never.