---
title: "Emojis · Nuxt OG Image · Nuxt SEO"
canonical_url: "https://nuxtseo.com/docs/og-image/v5/guides/emojis"
last_updated: "2026-08-16T10:00:30.231Z"
meta:
  description: "Use emojis in your OG Images."
  "og:description": "Use emojis in your OG Images."
  "og:title": "Emojis · Nuxt OG Image · Nuxt SEO"
---

Nuxt SEO on GitHub

You're viewing **OG Image v5** documentation. For the latest, [~~switch to v6~~](https://nuxtseo.com/docs/og-image/getting-started/introduction).

](https://nuxtseo.com/docs/og-image/v5/getting-started/introduction)

](https://nuxtseo.com/docs/og-image/v5/api/define-og-image)

](https://nuxtseo.com/docs/og-image/v5/releases/v5)

Switch to OG Image](https://nuxtseo.com/docs/og-image/getting-started/introduction)Switch to Nuxt SEO](https://nuxtseo.com/docs/nuxt-seo/getting-started/introduction)Switch to Robots](https://nuxtseo.com/docs/robots/getting-started/introduction)Switch to Sitemap](https://nuxtseo.com/docs/sitemap/getting-started/introduction)Switch to Schema.org](https://nuxtseo.com/docs/schema-org/getting-started/introduction)Switch to Link Checker](https://nuxtseo.com/docs/link-checker/getting-started/introduction)Switch to SEO Utils](https://nuxtseo.com/docs/seo-utils/getting-started/introduction)Switch to Site Config](https://nuxtseo.com/docs/site-config/getting-started/introduction)Switch to Skew Protection](https://nuxtseo.com/docs/skew-protection/getting-started/introduction)Switch to AI Ready](https://nuxtseo.com/docs/ai-ready/getting-started/introduction)

**Core Concepts**

# **Emojis**

Nuxt OG Image integrates with the [**~~Iconify API~~**](https://iconify.design/docs/api/) to provide support for a number of emojis families.

Supported families: `**twemoji**`, `**noto**`, `**fluent-emoji**`, `**fluent-emoji-flat**`, `**fluent-emoji-high-contrast**`, `**noto-v1**`, `**emojione**`, `**emojione-monotone**`, `**emojione-v1**`, `**streamline-emojis**`, `**openmoji**`

The default emoji family is `**noto**`.

## How it works

There is a Regex that detects unicode emoji characters in your template. When it finds them, it will map the characters to the emoji name.

For example, the unicode character `**U+1F600**` (`**😀**`) will be mapped to `**grinning-face**`.

Once we have the emoji name, we can use the Iconify API to fetch the SVG for that emoji, for example `**https://api.iconify.design/noto/grinning-face.svg**`.

You should be mindful of the number of emojis you use in your template, as each one will result in a separate API request.

## Configuring the emoji family

You can set the default emoji family within your module config.

nuxt.config.ts

```ts
export default defineNuxtConfig({
  ogImage: {
    defaults: {
      emojis: 'twemoji'
    }
  }
})
```

## Per-page emoji family

You can also set the emoji family on a per-page basis.

pages/index.vue

```ts
defineOgImage({
  emojis: 'twemoji'
})
```

**Was this page helpful?**

[**Non-English Locales** How to use the Nuxt OG Image module with non-english locales.](https://nuxtseo.com/docs/og-image/v5/guides/non-english-locales) [**Icons and Images** How to use icons and images in your templates.](https://nuxtseo.com/docs/og-image/v5/guides/icons-and-images)