Back to Blogs

Announcing General Availability of Contentstack’s GraphQL Content Delivery API

Feb 25, 2021 | Sebastian Rodrigues

Share on:

It’s official. Contentstack’s GraphQL Content Delivery API is now available to all customers.

When we first added support for GraphQL about two years ago, we saw it as a natural addition to a developers’ arsenal. We knew that providing more stable support would unlock tremendous value for developers and provide an efficient way to query data, no matter what they plan to build.

In the last two years, we worked hard to achieve that. We brought significant improvements in terms of capability, stability, and performance. Having proven itself over many months with customers using it in production, we are moving our GraphQL Content Delivery API from limited availability to general availability. Additionally, this latest release offers further rate limit increases, better stability, the ability to query multiple content types in a single request, and more.

Before we dig into what has changed from our Limited Availability version, here are highlights of the capabilities of our GA GraphQL API:

  • Rate limit of 80 requests per second per organization, in addition to the existing REST rate limit
  • Query entries of up to three content types in a single request
  • Paginate responses for referenced data and assets
  • Use relay specification logic to traverse through Reference field data
  • Retrieve data of different types of custom fields
  • Paginate introspection schema details
  • Use postman collection to test our GraphQL API

Now let’s look at some of the changes we have brought in this GA release from our Limited Availability version.

Higher Rate Limits

Our Limited Availability version had a rate limit of 3 requests per second per organization. We have increased the default limit to 80 requests per second per organization for uncached GraphQL requests to accommodate more production use cases. For requests that fetch content from our CDN cache, there is no rate limit.

Query More Content Types in a Single Request

You can now retrieve entries of up to three content types in a single GraphQL API request.

Here’s an example request that shows how you can fetch values of the Title field of entries of multiple content types.
query {
  all_product {
    items {
  all_category {
    items {
  all_brand {
    items {

Limits on Query Complexity and Cost

GraphQL gives developers the ability to make complex queries. While this is an advantage for the requester, it also opens up certain security risks. A malicious attacker can request a heavy, nested query that can overload the server or database. Or even legitimate users can inadvertently request data that may cause performance issues.

One of the best strategies to mitigate such risks is to set the following standards:

  • A single GraphQL query can fetch a maximum of 7,500 records
  • A single GraphQL query can fetch a maximum of 100 referenced records for a single Reference field connection
  • You can use the skip and limit pagination parameters to fetch more reference connection records

We do a cost and complexity analysis before executing the query and restrict the query from being executed if it exceeds the set limits.

Let’s look at an example to understand how we do this:

  all_blogs(limit:100) {
    items {
      related_blogsConnection(limit:75) {
        edges {
          node {
            ... on Blogs {

Now, we calculate the total records (entries) the above query is trying to fetch:

Depth 0 (Blogs Content Type) = 100 blog entries

Depth 1 (Related Blogs Reference Field): 100 x 75 = 7,500 related blog entries

Total Blog Entries: 100 blog entries + 7,500 related blog entries = 7,600 entries

Since the total entry count exceeds the maximum allowed limit of 7,500, we can prevent this query from connecting to the database.

If you intend to fetch more data, we recommend you paginate the references effectively and make multiple requests.

Refer to our documentation to learn more about how we calculate query cost and complexity.

Breaking Changes to Keep in Mind

Contentstack will continue to support the GraphQL Content Delivery API Limited Availability version for 30 days post the GA release.

To facilitate a smooth transition to the newer version of the API, we have listed below a few breaking changes in the API that you need to update within your backend code. You can incorporate these changes before the duration (mentioned above) to avoid schema build errors.

Update to All Asset Related Typenames

Contentstack converts every field UID to its corresponding GraphQL typename that follows the Pascal naming convention. However, a few instances may involve two different fields or objects having the same typename. This occurrence is referred to as a Typename Collision.

In our endeavor to avoid typename collisions, we prefix all asset-related GraphQL typenames with “SysAsset” instead of “Asset.”

Here’s a list of all the system-defined fields that have changed:

  • "Asset" to "SysAsset"
  • "AssetWhere" to "SysAssetWhere"
  • "AssetConnection" to "SysAssetConnection"
  • "AssetEdge" to "SysAssetEdge"
  • "AllAssets" to "AllSysAsset"
  • "AssetSystemField" to "SysAssetSystemField"
  • "AssetDimension" to "SysAssetDimension"
  • "AssetDimensionWhere" to "SysAssetDimensionWhere"
  • "AssetOrderBy" to "SysAssetOrderBy"
  • "TransformUrl" to "SysAssetTransformUrl"
  • "ImageFormats" to "SysAssetImageFormats"
  • "DisableValues" to "SysAssetDisableValues"
  • "FitValues" to "SysAssetFitValues"
  • "OrientValues" to "SysAssetOrientValues"
  • "OverlayAlignValues" to "SysAssetOverlayAlignValues"
  • "OverlayRepeatValues" to "SysAssetOverlayRepeatValues"
  • "AutoValues" to "SysAssetAutoValues"
  • "DispositionValues" to "SysAssetDispositionValues"

Introduction of the X-Resolver-Cost Response Header

To prevent malicious queries from hitting our backend database, we now perform a static analysis of each query before it hits the database. The x-resolver-cost response header calculates the worst-case response size that can be fetched by the query and provides an apt query cost analysis. This response header returns the total number of database round trips made for a single GraphQL query.

Future Steps

Contentstack will continue to add more capabilities to our GraphQL Content Delivery API as we go forward. Check our Change Log section to see the complete list of changes. To get started with your GraphQL API, check out our developer documentation.

Share on:

Recommended posts

May 08, 2023 | 2 min. read

What’s new and what’s in store for Contentstack Launch

Are you a developer looking for the latest data on Contentstack’s front-end hosting solution? Then look no further. Contentstack Launch has officially entered its first quarter since announcing our product, which is now in general availability, and we’ve earned a wealth of knowledge and cultivated relationships along the way. In this blog post, we’ll take an in-depth look at our successes over Q1, provide insights into how it all came to be and what users can expect from us moving forward. We pride ourselves on continuously innovating our products so that anyone using the platform can benefit right away with maximum efficiency. Let’s explore together!New features added in Q1Contentstack Launch is the ideal front-end hosting solution for your business, providing developers with a roadmap to success. As the only MACH-compliant platform on the market, Contentstack goes beyond any other offering by streamlining workflows, optimizing development operations, and improving business outcomes all through clicks not code. By reducing wait-states and eliminating friction between back-end code and front-end user experiences, Contentstack Launch has everything developers need to take their projects to the next level.Contentstack remains committed to providing developers and operations teams with the highest quality front-end hosting solution. During Q1, numerous features have been added and improved upon to ensure they can take advantage of tools such as:Local testingAutomationsStaging environmentsGIT repository linkingCDN/caching for optimal performanceIn addition, users now enjoy greater flexibility with automated redeployments and cache refreshing via webhooks — leading to faster turnaround times and smoother transition from development to production states of their content. With these new enhancements, Contentstack has the full solution for your stack.What’s in store for Q2We strive to create the best workflow experience for developers. In Q2, this means exploring multiple avenues for streamlining operations and improving user experience. To start, our team is developing support for more frameworks so customers receive greater flexibility when working with our hosting solutions. We’re also expecting to launch on-demand revalidation (ODR) for Nextjs very soon so developers can respond quickly to user requests. And lastly, look out for availability on European AWS and Azure data centers — opening up new opportunities for high-performance delivery on a global scale. Exciting times are ahead!Now, did that get you interested in learning more?Contentstack Launch has revolutionized how modern developers build and host front-end applications. Its features create a more streamlined workflow and improved user experience. The Q1 recap featured improvements made to the situation of modern developers in this regard. With these measures in place, Contentstack's platform is better equipped to handle dev operations efficiently and effectively.  In Q2, we are looking forward to expanding our offering even further with deeper integrations, additional product launches, and events. We encourage everyone to take advantage of Contentstack Launch's best practices for development operations by visiting our website for more information.Learn moreIf you'd like to learn how Contentstack Launch can help your business, click this link: and get started today!

May 04, 2023 | 3 min. read

Spring recap: What's new and what's coming for Contentstack

Welcome to Contentstack Pulse, your go-to source for the latest news on platform enhancements, roadmap updates and answers to frequently asked questions. Our mission is to keep you up-to-date on all the exciting developments at Contentstack and with our platform. Each month, we'll share the latest platform news to help you streamline your user experience. And every quarter, we'll offer a recap of everything that's happened, so you never miss a beat. Whether you're an existing customer or just curious to learn more about what we do, Contentstack Pulse has got you covered.We hope you can use this information to better leverage new features, learn from success stories and discover new tools for delivering engaging customer experiences. These recaps should also provide valuable insights into strategic growth initiatives and product innovations that will help you make the most of your experience with Contentstack.What we've accomplishedHere’s what we released in Q1:Contentstack Headless CMSSearch Relevancy: Improved search through stemming and word form support, accent-insensitive searching as well as the automatic ignoring of stop words for more accurate results.Entry Editor Experience: Now updated with prominent field blocks, smarter nested fields and more flexible custom fields for seamless content creation for business users.In-line Commenting in JSON RTE: Introducing further enhanced collaboration between teams, allowing business users and developers to collaborate and easily communicate about content.Contentstack MarketplaceRelease Preview App: View your releases in a calendar and timeline view within our new Full-Page extension location. Preview your content before a scheduled release and compare changes scheduled for your stack with upcoming releases or content you already have published. View other release details such as entries or assets that are added to a release with their specific titles, content types, and versions within your Contentstack environment.Interstack Reference App: Reference entries between stacks, similar to referring entries between content types within a stack. Easily fetch the referenced entry across your Contentstack environments without ever leaving your current stack, ensuring the availability of content across the entire enterprise and reducing manual maintenance of managing duplicate data.Contentstack AI Assistant: Our new integration brings the power of OpenAI ChatGPT instantly to the point of content creation through in-line UI extensions, allowing content editors and publishers to create a brand- and tone-specific content in seconds.Contentstack Automation HubConditional and Repeat Paths: Easily create complex workflows by defining multiple paths with conditional logic and repeating steps, saving time and effort for developers and business users.Project Sharing: For improved team collaboration and efficiency, users can now invite others to view, create and modify a project’s automation steps.ChatGPT Automation Hub Connector: Developers and business users can now leverage ChatGPT’s capabilities to unlock new possibilities in their workflows, including metadata extraction, text summarization and so much more.Contentstack LaunchEarly Access Program: General availability is scheduled for May 2023.Support for serverless functions: Next.js, Gatsby, webhooks and more advanced features are supported to enhance user experience and performanceWhere we're headingLooking ahead to Q2, we have an exciting lineup of features and innovations designed to provide you with endless opportunities and possibilities. Here’s a sneak peek:Assisted Search functionality will offer more accurate and relevant results when searching for content within the platform.Teams & Taxonomy will empower businesses to create a streamlined content management system with powerful tools for grouping and categorizing content. Content Type Visualizer App will provide businesses with a visual representation of their content types. The app's dashboard allows teams to see an overview of their entire content structure, enabling companies to manage and organize content more effectively.Predictive data capabilities: Automation Hub will be able to leverage its access and knowledge of the Contentstack system to improve user-friendliness by doing things like automatically creating trigger payloads or suggesting the right data values to include in various fields to users.Availability in AWS EU and Azure EU data centers will provide businesses with increased flexibility and choice when it comes to choosing their infrastructure. This feature allows users to choose from a range of data centers across Europe — including options in London, Paris and Frankfurt — offered by Amazon Web Services and Microsoft Azure.Contentstack's composable digital experience platform (DXP) offers a powerful and streamlined solution to achieve your digital goals. The platform provides a wide range of advanced features, from content modeling to composability to built-in integrations with services, unlocking tremendous potential for personalization, scalability and efficiency. We look forward each month to highlighting our latest enhancements designed to help you get the most out of our platform and the digital experiences you are building.If you're an existing Contentstack user wanting to learn more about these new releases, please reach out to your Care Without Compromise™ team.If you're curious about how Contentstack can help your brand streamline content to deliver better digital experiences everywhere, get in touch with our team here.Chalo!

Apr 18, 2023 | 2 min. read

Contentstack Marketplace: Bringing together best-in-class experiences

Contentstack Marketplace is the one-stop shop for ready-made extensions and one-click integrations with the industry's leading technology and service providers. Discover an extensive ecosystem of features, services, apps, and accelerators and combine the best technologies to achieve your desired business outcomes.The team behind Contentstack Marketplace is constantly working hard to keep up with the ever-changing landscape of applications and services. They are continually researching, creating and integrating new technologies and solutions to ensure our customers have access to the best tools and services available.Here are the latest innovations from the Marketplace team:Release Preview AppView your releases in a calendar and timeline view within our new full-page extension location. Preview your content prior to a scheduled release and compare changes scheduled for your stack with upcoming releases or content you have already published. View other release details such as entries or assets that are added to a release with their titles, content types and versions within your Contentstack environment.Interstack Reference AppReference entries between stacks, similar to referring entries between content types within a stack. Easily fetch the referenced entry across your Contentstack stacks without ever leaving your current one, ensuring the availability of content across the entire enterprise and reducing manual maintenance of managing duplicate data.At Contentstack, our team is dedicated to providing the highest level of customer service by continuously creating and integrating new technologies. With Release Preview, Interstack References and more available in our Marketplace, we make it easy to explore different solutions for your projects. Whether you’re looking for a comprehensive solution or just trying something out, Contentstack ensures that your digital experiences are tailored to your needs with its vast selection of integrations and add-ons. So go ahead — start exploring!Get started todayVisit Contentstack Marketplace today to learn more about how these new integrations can help you unlock the potential of your digital experiences.

May 24, 2022

Introducing Automation Hub for Speed, Flexibility and Scalability

In the last decade, we’ve seen three things separate thriving enterprises from the rest of the pack:SpeedFlexibilityScalability for the futureThey’re the reason why the adoption of composable architecture (or stacks) has soared to an early majority state in the last couple of years. Dawn Foods is a prime example. When they integrated their CMS with their product catalog, one-click order platform and online payment portal, online orders increased by 50%. They also successfully launched six major products within six months of implementation. The composable approach gave them the flexibility and scalability needed to grow the business. Analysts are convinced. Gartner® predicted that “by 2023, organizations that adopt an intelligent, composable approach will outpace their competition by 80% when it comes to the speed of new feature implementation.” Many enterprises recognize that composable architectures with best-of-breed technologies are the way forward. But moving away from monolithic legacy systems to a world of choice isn’t exactly easy. The average marketing organization has deployed 91 different tools across its stack, and the process of integrating them introduces a host of technical and operational challenges. You might have the best stack in the world, but if all the technologies don't communicate and interact with each other, what are you left with? Fragmentation—and a lot of time and frustration spent dealing with it. That’s why we’re launching our industry-first Automation Hub and Connect Without Compromise™ program: to simplify the process of creating composable experiences for organizations. There are three ways this program makes integration fast, easy and seamless. Launching Today: Automation Hub to Overcome Integration Hell While leveraging best-of-breed technologies is the only way to stay competitive, enterprises often find themselves bogged down in what we call “integration hell.” Imagine opening one application to make a change, only to have to open another application to update the data there too, and then another to close the gap there… and APIs only help so much. The solution typically involves writing complex code that is often slow, brittle and requires constant maintenance—not much of a solution. But what if you could enable all these applications to perform tasks automatically with low code – even no code – all within a centralized location? That’s the goal of Automation Hub. Users are no longer forced to weave in and out of applications and manually perform several sub-tasks to accomplish the overall activity. Instead, they can build the flow visually inside Automation Hub, and those sub-tasks complete automatically. As organizations continue to adopt technologies, Automation Hub saves time across the board by automating and streamlining the hundreds of activities that happen across stacks several times every month. It also improves governance by knowing what each step is and how it executes every time — and that’s where the real value lies. Integrate the Tried-and-true Functionality Your Organization Needs with Marketplace Another component of Connect without Compromise™ is Marketplace, a one-stop library of applications to incorporate the functionality you need into your stack. Choose from a wide selection of partner-developed, customer-developed and Contentstack-native applications and quickly integrate them with just a few clicks. The Developer Hub inside Marketplace gives developers a tool to package apps, iterate new versions and set up authentication and security measures. The Venus Component Library ensures the application looks and feels native to your stack and supplies reusable front-end components to speed development along. And if you’re looking to understand what integrations you’re using and where they’re incorporated, Marketplace provides an audit log. Even if you’re unsure what the next step in your composable journey is, the entire library is available to browse. See what other partner or customer organizations have integrated into their stacks and adopt what your organization needs. Building your stack on our extensible app framework ensures that as your organization grows, the tools you need to carry out operations will scale with it. Easy Access to Expertise with Blueprints What if you have never worked with a headless provider or need extra help with implementation? This is where Blueprints comes in. Blueprints is our library of best practices, expert guides and use cases for creating composable experiences. See what others have done before, learn how they accomplished it and what to avoid. Whether or not you’ve worked with composable architecture before, we’ve made it easier for anyone to create as if you have. Connect Without Compromise™ eliminates obstacles so businesses can embrace composable architectures with confidence. Speed, flexibility and scalability for the future are not only within reach, but easier to achieve than ever before. With our foundation, framework and support, businesses will be able to get their composable experiences up and running and create at the speed of their imagination. Now that we’ve made it so much easier, the question is: what will you create Automation Hub BETA will be available in late Summer 2022.

May 23, 2022

Build, Integrate, and Publish Apps With the Developer Hub

Contentstack is excited to introduce Developer Hub, a powerful platform that allows you to build apps, create integrations for your specific business needs and publish them on Marketplace.The Developer Hub (in Open Beta) is an app development platform that comes with Apps APIs, SDK and other tools to help you build apps with ease. Using these tools, you can develop private apps (only for your organization) and public apps (listed in the Public Marketplace for any Contentstack customers to use) such as third-party integrations, Contentstack apps and more.Developer Hub: The Power to BuildIf you are a developer, Developer Hub lets you build apps to extend the core functionalities of Contentstack and use them in your organizations or stacks. These apps can be extensions or integration solutions (packaged as apps), with any UI location of your choice. You can decide where these apps are rendered — as a field, sidebar widget, dashboard widget, RTE plugin or other location.We have created a comprehensive guide to help you get started with building apps. We have also included tutorials for sample apps that can get you up to speed immediately.If the Marketplace apps sound similar to extensions, it’s because they are. Apps are the future of integrating and implementing third-party solutions within your CMS. Compared to extensions, apps offer advanced functionalities as they extend all the features of your current extensions and more to provide seamless integration with your favorite third-party platforms.You can learn more about how Marketplace apps are different from extensions, which one will suit your requirements and how to convert your existing extensions into apps.How Can You Start Creating an App With Developer Hub?Note: If you do not see Developer Hub in your organization, kindly contact our Support Team,To start creating an app with Developer Hub, you need to perform the following steps:Download and use our boilerplate that will set up your project from scratch using the App SDK.Install Node version 12 in the app drive.Next, log in to your Contentstack account and click on the “Developer Hub” icon that you see on the left navigation panel.You'll see the Developer Hub landing page where you can start setting up your app. Configure the OAuth, UI locations and Webhooks.Once set up, install the app in your organization or stack according to your setup.Now, update the boilerplate code to suit your application’s needs and test it out.For more information on how to create and manage your apps, see our extensive Developer Hub guide.Contentstack Marketplace and Developer Hub: The Dual AdvantageContentstack Marketplace is a platform that allows you to connect apps and other services and make them work for you quickly and efficiently. These applications are easy to install and have all the resources you need for every step of the development process.Currently, Algolia, BigCommerce, Shopify, and Cloudinary are among the top integration apps that you will find in Contentstack Marketplace, with more to come soon.With Contentstack Developer Hub, you get the ability to create your own apps, and with the right approvals, you can even get them listed in Contentstack Marketplace so others can install and use them.For more information about this, refer to our App Submission and Approval Guidelines.What’s next?We will continue to improve user experiences with Developer Hub in upcoming releases. Also, we will provide app hosting abilities where users can upload their app code directly into Contentstack without having to rely on external third-party apps. We also plan to add more locations where these apps can be placed. Stay tuned!