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

# Emoji analysis

> Plot the emojis used across ad copy against two metrics to see which perform best.

An **emoji analysis** widget extracts the emojis used in ad copy across a set of creatives and plots each unique emoji as a data point on a two-dimensional grid. The X-axis is one metric, the Y-axis is another. It's useful for spotting which emojis correlate with the strongest performance — for example, "which emoji in ad copy drives the highest CTR at the lowest CPA?"

## When to use emoji analysis

* **Test which emojis resonate** with a target audience.
* **Compare emoji performance across two metrics** — for example, Spend vs Conversions.
* **Identify high-performing emojis** to prioritize in future creative rotations.

## Configure an emoji analysis widget

### Mandatory fields

<Steps>
  <Step title="Pick a data source">
    In the **Data sources** section, select ad data sources whose creatives include emoji-containing copy. Emoji analysis reads emojis from ad copy — non-ad data sources don't provide this.
  </Step>

  <Step title="Pick a Y-axis metric">
    Click **Edit** on the Y-axis field to open the picker panel. Pick up to **20 metrics** to make available in the widget's dropdown, reorder them if needed, and set the active one shown by default. The active metric renders as the value plotted on the vertical axis — for example, CTR or Conversions.

    New custom metrics can be created directly from the picker panel without leaving the chart widget.
  </Step>

  <Step title="Pick an X-axis metric">
    Click **Edit** on the X-axis field to open the picker panel. Pick up to **20 metrics** to make available in the widget's dropdown, reorder them if needed, and set the active one shown by default. The active metric renders as the value plotted on the horizontal axis — for example, Spend. Each emoji is plotted at (X, Y).
  </Step>
</Steps>

Emoji analysis widgets don't have a Group by picker — the "groups" are the individual emojis extracted from ad copy automatically.

Widget changes save automatically when the settings panel closes. Persist changes to the dashboard by clicking **Save dashboard**.

### Optional fields

* **Widget filter** — narrow the creatives feeding the widget. See [Filters](/dashboards/filters-and-dates/filters).
* **Hide metric value** — hide items whose **Ad Spend**, **Impressions**, or **Link Clicks** meet a threshold. Two blocks are available: a preset "Value = 0" checkbox per metric, and a custom threshold block with an operator (default `≤`) and value. Both can be combined.
* **Period** — override the dashboard's date range. See [Date ranges](/dashboards/filters-and-dates/date-ranges).
* **Grid** — toggle background gridlines.

## What the visual encodes

* **Point position** — the emoji's aggregate value on the X and Y metrics.
* **Point label** — the emoji itself.
* **Chart controls** — toggle whether Chart controls render on this widget. On by default.

## Chart controls

Chart controls are toggled on or off per widget from the **Chart controls** switch in the widget settings panel. When off, Chart controls don't render on the widget; when on, the dropdowns configured below appear on the widget.

Some key settings can be updated directly from the widget header without opening the settings panel. The **Chart controls** on an emoji analysis widget expose:

* **Chart type** — a switcher on the left of the widget header to change to another chart type.
* **Y-axis** — swap the vertical metric inline.
* **X-axis** — swap the horizontal metric inline.

Changes made in the Chart controls **aren't saved automatically** — click **Save dashboard** to persist them. Chart controls are read-only when viewing a shared dashboard. In shared dashboards, Chart controls show only the items selected in each field, matching what the dashboard owner configured.

## Comparison mode

**Emoji analysis widgets do not render comparison values.** Even when the Compare toggle is on, the widget draws only the primary window.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The chart is empty ('No data available')">
    Emoji analysis needs ad data sources with emojis in creative copy. Confirm the selected data sources include ads whose copy contains emojis, and that the date range covers periods with active creatives. See [Data not loading](/troubleshooting/data-not-loading).
  </Accordion>

  <Accordion title="Only one or two emojis appear">
    The visible creative set uses very few distinct emojis. Widen the date range or ad-account selection to include more creatives.
  </Accordion>

  <Accordion title="Non-ad data source is selected">
    Emoji analysis only works with ad data sources — the emoji set is derived from ad copy. Remove non-ad sources.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Word cloud" href="/widgets/widget-library/chart-widgets/word-cloud">
    Same idea for words rather than emojis.
  </Card>

  <Card title="Color clustering" href="/widgets/widget-library/chart-widgets/color-clustering">
    Group creatives by dominant color rather than text.
  </Card>

  <Card title="Scatter plot" href="/widgets/widget-library/chart-widgets/scatter-plot">
    Plot any two numeric metrics with a Group by.
  </Card>
</CardGroup>