> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.omni.co/feedback

```json
{
  "path": "/administration/settings/emoji",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Emoji settings

> Configure emoji mode for query tabs and manage custom emoji at the organization level.

Emoji settings let you control how query tabs are named in workbooks and manage custom emoji across your Omni organization. You can toggle between emoji-based and sequential tab names, set overrides for embedded experiences, and use custom emoji in dashboards, Markdown, and more.

## Requirements

**Organization Admin permissions** are required to access emoji settings.

## Accessing emoji settings

Organization-level emoji settings are managed in **Settings > Emoji**.

### Emoji tabs

The **Emoji tabs** setting controls how new query tabs are named when users create them in workbooks.

* **When enabled** (default): New query tabs are named with emoji prefixes (for example, "🔍 Query")
* **When disabled**: New query tabs are named sequentially (for example, "Query 1", "Query 2", "Query 3")

This setting applies to all users in your organization by default.

### Sequential tab naming

When emoji mode is disabled, Omni uses the workbook's tab index to generate sequential names:

* The first query tab is named "Query 1"
* The second query tab is named "Query 2"
* Additional tabs continue this pattern

This naming convention helps users quickly identify and reference specific query tabs in workbooks with many queries.

## Embed emoji override

For embedded Omni experiences, you can set a separate emoji mode that overrides the organization-level setting.

The **Embed emoji tabs** setting allows you to:

* Enable emoji mode for embed sessions while keeping it disabled for your internal users
* Disable emoji mode for embed sessions while keeping it enabled for your internal users
* Leave it unset to use the organization-level **Emoji mode** for both internal and embed users

When set, this override applies to all embed sessions in your organization. Embed users will see query tab names based on this setting rather than the organization-level emoji mode.

## Custom emoji

<Note>
  Custom emoji is currently in beta. Additionally, this feature is only available to non-white-labeled embed organizations.
</Note>

Omni's custom emoji catalog (Blobby) provides additional emoji options beyond the standard set. You can use custom emoji throughout Omni to add visual context and personality to your content.

White-label organizations do not have access to custom emoji, as the catalog contains Omni-branded emoji characters.

### Using custom emoji

<Note>
  While **Organization Admin** permissions are required to access emoji settings, users with lesser permissions can use custom emoji in Omni.
</Note>

You can insert custom emoji anywhere text is supported by using the `:emoji-name:` syntax. For example, typing `:blobby-wave:` will render the waving Blobby emoji.

Custom emoji works in the following locations:

* **Dashboard tile titles** - Add emoji to visualization and text tile titles for visual categorization
* **Markdown content** - Use emoji in markdown text tiles and markdown visualizations
* **Workbook tab names** - Include emoji in query tab names to make them more recognizable
* **Field labels** - Add emoji to dimension and measure labels in the modeling layer

### Limitations

* Downloads and deliveries are not yet supported
* Custom emoji will not render inside code blocks or inline code elements. This ensures that emoji syntax in code examples remains as plain text.

### Syntax

To use a custom emoji, wrap the emoji name in colons:

```text theme={null}
:emoji-name:
```

For example:

```text theme={null}
:blobby: Welcome to our dashboard!
```

This will render as:

> <Icon icon="https://mintcdn.com/omni-e7402367/qaBJ-B3EjoUSqHbo/snippets/icons/blobby.ico?fit=max&auto=format&n=qaBJ-B3EjoUSqHbo&q=85&s=d821c1ec8aa65710e62e9f1171fc3770" className="no-border" width="256" height="256" data-path="snippets/icons/blobby.ico" />  Welcome to our dashboard!

You can use multiple emoji in the same text:

```
:blobby-chart: Sales metrics :blobby-up:
```