Skip to main content

Submit to Site Showcase

Want to submit a site to the Site Showcase? Follow these instructions.


There are three major steps:

  1. If this is your first contribution to the Gatsby open source repo, follow the Contribution guidelines.

  2. If there is a chance that someone else could have already submitted the site, please make sure no one else has already submitted it by searching existing PRs:

  3. Edit the sites.yml file by adding your submission to the bottom of the list of sites in the following format:

Use the following template to ensure required fields are filled:

Helpful information


Categories currently include both type of site (structure) and the content of the site. You will place all these under “categories” in your submission for now. The reason these are in two separate lists here is to show that you can have a school’s marketing site (type of site would be marketing, and content would be education) or a site that delivers online learning about marketing (type of site would be education and content would be marketing).

Type of site

  • Blog
  • Directory
  • Documentation
  • eCommerce
  • Education
  • Portfolio
  • Gallery
  • See categories.yml for an up to date list of valid categories.

Content of site

A few notes on site content: a common question is this: “aren’t all Gatsby sites technically in the “web development” category?” Well, no because this category means the content of the site has to be about web development, like ReactJS. Also, the difference between technology and web development is like this. Cardiogram is technology, while ReactJS is web development.

  • Agency
  • Education
  • Entertainment
  • Finance
  • Food
  • Healthcare
  • Government
  • Marketing
  • Music
  • Media
  • Nonprofit
  • Open Source
  • Photography
  • Podcast
  • Real Estate
  • Science
  • Technology
  • Web Development
  • See categories.yml for an up to date list of valid categories.

Adding new tag

If you think that there is something missing in the tag list, you can update categories.yml and add a new one. However, we encourage you to use existing tags.

Review process

By default, all sites submitted to the Site Showcase will be reviewed by the Gatsby Site Review Board as a candidate for the ‘Featured Sites’ section of the showcase. If you do not want your site to be featured, please add ‘DO NOT FEATURE’ to the pull request.

Featured sites will be chosen quarterly based on the following criteria:

  • Well known brands
  • Use case diversity
  • Visual appeal
  • Visual diversity

9, since that’s what can fit on one page of the site showcase

Note: the Gatsby team will choose featured sites, leave as featured: false when first posting

If your site is chosen as featured, here’s what to do next:

  1. Change featured: false to featured: true

  2. Add featured as a category:

Need to change your submission?

If you want to edit anything in your site submission later, simply edit the .yml file by submitting another PR.

Edit this page on GitHub