Link Search Menu Expand Document

Rendering Emoji

Emoji rendering is built in and handled automatically for you.


How it works

Emoji’s are automatically replaced with images for consistent and clear rendering. This is enabled for you by default.

Emoji support in HTML/CSS to Image API

emoji class

Each image has an emojiclass added to it on render. This makes it easy to tweak their display.

Here is the default CSS we apply to all emoji. To make tweaks, adjust it and include it in your CSS to override the defaults.

/* Take advantage of the built in 'emoji' class to modify the display of emoji */
img.emoji {
  height: 2em;
  width: 2em;
  margin: 0 .05em 0 .1em;
}

Disabling Twemoji

By default, we use Twemoji to render emoji as images for consistent cross-platform display. If you prefer to use the native emoji fonts instead (the API runs on Linux servers), you can disable Twemoji with the disable_twemoji parameter.

When to disable Twemoji

  • You’re using a custom emoji font
  • You prefer the native system (linux) emoji appearance

Example

{
  "html": "<div>Hello 👋 World 🌍</div>",
  "disable_twemoji": true
}

Note

When Twemoji is disabled, emoji appearance will vary depending on the fonts available in our rendering environment. Twemoji provides more consistent results across all images.


Need help?

We’re always looking to improve this documentation. Please send us an email: support@htmlcsstoimage.com. We respond fast.


Back to top

Built with extensive integration tests and serious care for developer happiness.
© 2018-2025 Code Happy, LLC.

Page last modified: Dec 31 2025 at 09:49 PM.

Edit this page on GitHub.