Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub

[DEPRECATED] gatsby-remark-a11y-emoji

This plugin is now directly included in @fec/remark-a11y-emoji.

Gatsby Plugin to make Emoji in Markdown accessible. Wraps Emoji in a <span>-Tag with role and aria-label attributes.

Unit tests Integration tests

Made by 👨‍💻 Florian Eckerstorfer in 🎡 Vienna, Europe.

Table of Contents

  1. Motivation
  2. Requirements
  3. Installation
  4. License
  5. Change log


Everyone loves emoji 💯🎉🔥, but if you use eslint-plugin-jsx-a11y to check the accessibility of your JSX you probably know that Emoji need special handling to become accessible. Instead of just writing the emoji, you need to wrap it in a span and add role="img" and aria-label attributes.

This plugin does this automatically for you.

Gatsby is 💯

will turn into

Gatsby is <span role="img" aria-label="hundred points">💯</span>


  • Node >=10.13.0 (same as Gatsby)


First you need to install the plugin with NPM or Yarn:

npm install --save gatsby-remark-a11y-emoji

Add the plugin to gatsby-config.js. Since gatsby-remark-a11y-emoji converts Remark text nodes into html nodes, I recommend placing it at the very end of the plugins list.

module.exports = {
  // ...
  plugins: [
      resolve: `gatsby-transformer-remark`,
      options: {
        plugins: [
          // ...



Change log


© 2023 Gatsby, Inc.