Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

  • Gatsbyjs.com
    Gatsbyjs.com
  • Gatsby Cloud
    Gatsby Cloud
  • Documentation
    Documentation
  • Support
    Support
  • Contact
    Contact
  • Log in
    Log in
docs
    • Tutorial
      Tutorial
    • How-to Guides
      How-to Guides
    • Reference
      Reference
    • Conceptual Guide
      Conceptual Guide
    • Quick Start
      Quick Start
    • v3

      • v4 (beta)

        v4 (beta)

      • v3

        v3

      • v2

        v2

      • v1

        v1

DocumentationHow-to Guides
Docs

Plugins and Themes

Gatsby has a rich ecosystem of drop-in functionality, from CMS integrations to image optimizations.

This section has three parts. First, it covers how to use plugins, which is by far the most common use case. Second, it has documentation on themes, which enable you to modularize and re-use site sections between multiple sites. Third, it provides guides for creating and contributing a plugin to the ecosystem.

 Main Guides 3

Plugins→

Like other Node packages, you can install Gatsby plugins using npm or yarn. Then, add it to your `gatsby-config.js` along with values for any options it takes.

Themes→

Want to add a theme to an existing Gatsby site? No problem! Themes can be installed and configured like other plugins.

Create a source plugin→

There are currently over 500 source plugins -- basically, integrations between third-party sources (like CMSs) and Gatsby. If you need to integrate with a data source that isn't covered, or improve an existing integration, this guide will help.

 Additional Guides 13

  • Create a generic plugin
  • Start a new site with a theme
  • Naming a Plugin
  • Creating a Transformer Plugin
  • Configuring Usage with Plugin Options
  • Submit to Plugin Library
  • Maintaining a Plugin
  • Adding Gatsby Image support to your plugin
  • Create a theme
  • Converting a starter to a theme
  • Shadowing components in a Gatsby theme
  • Theme Composition
  • Theme Conventions
  • Accessibility Statement
  • Code of Conduct
  • Logo & Assets
  • Privacy Policy
  Docs
  • How-to Guides
    • Overview
    • Overview
    • Plugins
    • Themes
    • Create a source plugin
    • Additional Guides 13