--- title: "Gatsby Adapters: Realize the Full Potential of Gatsby on Your Platform" description: "Introducing the new Gatsby Adapters, allowing you to deploy your Gatsby site to Netlify, or any other platform, with ease. Adapters take the production output from Gatsby and turn it into something your deployment platform understands. This makes it incredibly easy to deploy Gatsby sites, enabling seamless integration with any platform." source: "https://www.gatsbyjs.com/blog/gatsby-adapters-realize-the-full-potential-of-gatsby-on-your-platform" last_updated: "2026-07-16T01:20:39.000Z" --- In the beginning, Gatsby was just a Static Site Generation but now it’s a [Reactive Site Generator](https://www.gatsbyjs.com/blog/re-introducing-gatsby-a-reactive-site-generator) that offers features like Deferred Static Generation, Server-Side Rendering, or serverless functions. These additional features require more glue code on deployment platforms and for self-hosting Gatsby. In the past, plugins had to work around missing features or reach into Gatsby’s internals. Luckily, these problems are now in the past as today we’re happy to introduce **Gatsby Adapters**! Adapters are responsible for taking the production output from Gatsby and turning it into something your deployment platform understands. We want to make it easier to deploy and host Gatsby on your preferred platform and Gatsby Adapters are a huge step towards that goal. But there’s still lots more to do. As our Director of Engineering, Claire Knight, wrote in [Taking Gatsby to New Heights: Embracing Adaptability and Openness](https://www.netlify.com/blog/taking-gatsby-to-new-heights-embracing-adaptability-and-openness/) we want to give you the power of Adapters, enabling seamless integrations between Gatsby and other platforms. Update `gatsby` to 5.12.0 (e.g. by running `npm install gatsby@latest`) and you can use and write Gatsby Adapters. ## Getting started By default, Gatsby will have a manifest of popular adapters it’ll reference during a build. This enables zero-configuration deployments on those deployment platforms. For these zero-configuration deployments, no manual user interaction is needed (e.g. no installation/usage of an “auto” package). For example, on Netlify `gatsby` will automatically install `gatsby-adapter-netlify`. You can manually install it inside your `dependencies` if you want to skip the auto-install on each build. The adapter will then set up everything needed to host Gatsby on Netlify. If you want to use an adapter that is not part of Gatsby’s manifest, you can install it into your `dependencies` and add it to your `gatsby-config` like so: ``` import type { GatsbyConfig } from "gatsby"import adapter from "gatsby-adapter-name" const config: GatsbyConfig = { adapter: adapter(),} export default config ``` As part of the work on Gatsby Adapters, you’re now also able to define custom HTTP headers inside `gatsby-config`: ``` import type { GatsbyConfig } from "gatsby" const config: GatsbyConfig = { headers: [ { source: "/some-path", headers: [ { key: "x-custom-header", value: "hello world" } ] } ]} export default config ``` Gatsby passes all the required information during the build to Adapters to prepare these outputs for deployment on a specific platform. Here are some of the actions an Adapter automatically takes: - Applies HTTP headers to assets - Applies redirects and rewrites. The adapter can also create its own redirects or rewrites if necessary, for example, to map serverless functions to internal URLs. - Wraps serverless functions coming from Gatsby with platform-specific code (if necessary). Gatsby will produce [Express](https://expressjs.com/)\-like handlers. - Apply trailing slash behavior and path prefix to URLs - Possibly uploads assets to CDN ## Learn more Gatsby Adapters are a great addition to the framework and a powerful feature. We have prepared a couple of new documentation pages for you to explain Gatsby Adapters in-depth. Check out these resources: - [Adapters Overview](https://gatsbyjs.com/docs/how-to/previews-deploys-hosting/adapters/): Learn how to find and use adapters - [Zero-Configuration Deployments](https://gatsbyjs.com/docs/how-to/previews-deploys-hosting/zero-configuration-deployments/): List of supported deployment platforms and how you can configure their adapters - [Creating an Adapter](https://gatsbyjs.com/docs/how-to/previews-deploys-hosting/creating-an-adapter/): You can build your own! Start to finish guide on how to create and publish an adapter. - [HTTP Headers](https://gatsbyjs.com/docs/how-to/previews-deploys-hosting/headers/): As part of the Gatsby Adapters work you can now also specify HTTP headers for a given path Also, check out the source code for [gatsby-adapter-netlify](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-adapter-netlify) and the [initial RFC](https://github.com/gatsbyjs/gatsby/discussions/38231) to see what a fully-featured adapter can look like and how the feature came to be. ## What’s next for the Gatsby ecosystem? Gatsby Adapters are just part of our vision for the Gatsby framework to have a great future not just here on Netlify, but also out in the wider world of web development. We have lots more that we’re eager to bring to life, some of which are designed to make not just Gatsby, but other frameworks more powerful and efficient here on Netlify. As we balance our work across the Gatsby framework and other parts of its platform and ecosystem and reinforce its future, rest assured that as a vital tool for so many business and organisations, Gatsby’s health and prosperity is important to us, and we’re excited about it. ### Share - [X (fka Twitter)](https://twitter.com/intent/tweet?text=Gatsby Adapters: Realize the Full Potential of Gatsby on Your Platform&url=https://www.netlify.com/blog/gatsby-adapters-realize-the-full-potential-of-gatsby-on-your-platform/) - [LinkedIn](https://www.linkedin.com/shareArticle?mini=true&url=https%3A%2F%2Fwww.netlify.com%2Fblog%2Fgatsby-adapters-realize-the-full-potential-of-gatsby-on-your-platform%2F) - [Facebook](https://www.facebook.com/sharer.php?u=https://www.netlify.com/blog/gatsby-adapters-realize-the-full-potential-of-gatsby-on-your-platform/) - [Bluesky](https://bsky.app/intent/compose?text=Gatsby Adapters: Realize the Full Potential of Gatsby on Your Platform+https://www.netlify.com/blog/gatsby-adapters-realize-the-full-potential-of-gatsby-on-your-platform/) * * * ### Tags - [Gatsby](/blog/tags/gatsby/) - [Open source](/blog/tags/open-source/) - [changelog](/blog/tags/changelog/) ## Keep reading ![](/_astro/c4b6eadcdfeb87012f85b6aae6d9e8be532552e9-1200x630_Z22ht1I.webp) News & Announcements June 30, 2023 [ ### Taking Gatsby to New Heights: Embracing Adaptability and Openness ](/blog/taking-gatsby-to-new-heights-embracing-adaptability-and-openness) - ![Profile picture of Claire Knight](/_astro/1fb0f514cbbfc8eeaaabe7fef7d0d061425f71b9-1309x1309_ZqCbH4.webp) Claire Knight ![](/_astro/0a6cec6fba055b799b383059e90b5961d31bf16b-1200x630_Z17cgb8.webp) Tools & Services June 21, 2022 [ ### Cut build times with Gatsby Runner ](/blog/cut-build-times-with-gatsby-runner) - ![Profile picture of Matt Kane](/_astro/4c627c2c5d44f0cd0018e70da18ee2b7557fd7dd-400x400_Z1hIjE6.webp) Matt Kane ## Recent posts News & Announcements July 14, 2026 [ ### More headroom, a lower per-credit rate, and a bill you can predict: introducing new Pro plan tiers ](/blog/new-pro-plan-tiers) - ![Profile picture of Gehrig Kunz](/_astro/b4e9f58d914d1334ea70d53ea55a1f26b26f1445-512x512_17SwOI.webp) Gehrig Kunz News & Announcements July 13, 2026 [ ### Netlify inside of Claude Design ](/blog/netlify-inside-of-claude-design) - ![Profile picture of Sean Roberts](/_astro/bbf2243f8171dbddd80ab2103622106cef84d125-512x512_Z1d2LKE.webp) Sean Roberts News & Announcements June 25, 2026 [ ### Netlify Functions, designed for Agent Experience ](/blog/netlify-functions-designed-for-agent-experience) - ![Profile picture of Eduardo Bouças](/_astro/52958f21e8450baf6d8e60302341a984e220c0cd-512x512_13VDlu.webp) Eduardo Bouças ![](/_astro/3f255b372fa958df35802666ee33b4609b2d71bd-1200x1586_1VtE2D.webp) ### How do the best dev and marketing teams work together? [Access the report](https://www.netlify.com/reports/2024-leadership-trend-report/access/)