1.2.1 • Public • Published

Gatsby Plugin security.txt

When security risks in web services are discovered by independent security researchers who understand the severity of the risk, they often lack the channels to disclose them properly. As a result, security issues may be communicated on inappropriate channels or left unreported.

security.txt is an Internet draft standard, submitted for RFC review, to help website owners define the process for security researchers to disclose security vulnerabilities securely.

Gatsby plugin "gatsby-plugin-security-txt" creates a text file called security.txt under the .well-known directory (see RFC5785) of your project on every Gatsby build.

Getting Started

  1. Install the package with npm or yarn

    npm install gatsby-plugin-security-txt

    yarn add gatsby-plugin-security-txt

  2. Add to plugins in your gatsby-config.js

module.exports = {
  plugins: ['gatsby-plugin-security-txt'],
  1. Run gatsby build

NB The resulting file will appear on path /.well-known/security.txt of your site only after it's built. It is not enough to run gatsby develop.


Name Type Description
intro string [OPTIONAL] Introductory words describing the use of the file. Default: "Information related to reporting security vulnerabilities of this site."
contact string [REQUIRED] A link or e-mail address for people to contact you about security issues. Remember to include "https://" for URLs, and "mailto:" for e-mails. See Default: —
expires string [REQUIRED] An ISO 8601 date and time after which the data contained in the "security.txt" file is considered stale and should not be used. See Default: —
encryption string [OPTIONAL] A link to a key which security researchers should use to securely talk to you. Remember to include "https://". See Default: —
acknowledgements string [OPTIONAL] A link to a web page where you say thank you to security researchers who have helped you. Remember to include "https://". See Default: —
languages string [OPTIONAL] A comma-separated list of language codes that your security team speaks. You may include more than one language. See Default: en
canonical string [OPTIONAL] The most common URL for accessing your security.txt file. It is important to include this if you are digitally signing the security.txt file, so that researchers can know for sure that you didn't just steal someone else's file with the same content. See Default: —
policy string [OPTIONAL] A link to a policy detailing what security researchers should do when searching for or reporting security issues. Remember to include "https://". See Default: —
hiring string [OPTIONAL] A link to any security-related job openings in your organisation. Remember to include "https://". See Default: —

Example Options

module.exports = {
  plugins: [
      resolve: 'gatsby-plugin-security-txt',
      options: {
        contact: '',
        expires: '2025-12-31T23:59:59z',
        canonical: '',
        languages: 'en, es, fr',

Example Implementations

A few real-world implementation examples of security.txt

More documentation

A body of additional documentation is growing at

We also welcome links to sites that make use of this plugin. Send us a representative link to your security.txt and we will consider it for inclusion on the documentation page.


The security.txt syntax follows specifications of the excellent security.txt.

Maintenance and development

Developed and maintained by Vacilando since 2020/02/10 — see the main article.

Every contribution is very much appreciated. Feel free to file bugs, feature- and pull-requests.

If this plugin is helpful for you, please star it on GitHub.

Package Sidebar


npm i gatsby-plugin-security-txt

Weekly Downloads






Unpacked Size

14.7 kB

Total Files


Last publish


  • vacilando