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

# Widgets

> Keep today's ad numbers on your Home Screen and Lock Screen, scoped to the workspace, an ad account, an ad tool, a platform or a market.

> [!NOTE]
>
> **Find it in** your iPhone or iPad Home Screen, long-press, **Edit**, add widget, Epsilo. Metrics in the app's account sheet, **Widget metrics**. **Last updated** 9 Oct 2026.

## Overview

The Epsilo widget, named **Console** in the widget gallery, shows today so far: one big metric, the intraday trend, and how today compares with a day you pick. Each widget follows one scope, so you can keep the whole workspace on one and a single ad account on another. Taps on the widget switch metrics and boards without opening the app.

## How it works

**1. Add the widget**

Long-press an empty spot on the Home Screen, tap **Edit**, then add a widget. Search for Epsilo and pick **Console** in the size you want.

**2. Choose what it follows**

Long-press the widget and tap **Edit Widget**. Set **Scope**, then pick the ad account, ad tool, platform or market.

**3. Choose the comparison and the board**

Set **Compare with** for the day today is measured against, and **Dashboard** for what the widget draws.

**4. Pick your metrics in the app**

In the app, open the account sheet and tap **Widget metrics**. The first metric is the big number.

## Sizes

| Where | Sizes |
| - | - |
| Home Screen | Small, Medium, Large |
| Home Screen on iOS 27 | Full, a full-page tile |
| Lock Screen | Rectangular, circular, inline |

## Use it

### Set the scope

**Scope** decides what the numbers add up:

* **Workspace**: every connected ad account.
* **Ad account**: one ad account.
* **Ad tool**: one ad tool across your ad accounts.
* **Platform**: one ad network.
* **Market**: one country.

When you pick a scope other than Workspace, a second row asks which one. Until you pick, the widget reads **Long-press this widget, then Edit Widget.**

### Compare with a past day

**Compare with** sets the day today is measured against, for the same hours:

* **Yesterday** (default)
* **Same day last week**
* **Same day last month**
* **Last double day**, the most recent sale day such as 9.9 or 10.10
* **Same double day last year**
* **Custom day (pick in the app)**

For a custom day, open the app's account sheet, tap **Widget benchmark day**, pick a date and tap **Use this day**. Every widget set to the custom day follows it. Tap **Clear** to remove it.

### Choose a dashboard

**Dashboard** sets the board the widget draws:

* **Scorecard**: the big number, supporting metrics and the intraday chart.
* **Ad account mix**, **Ad tool mix**, **Platform mix**, **Market mix**: today's big metric split across ad accounts, ad tools, networks or markets.
* **GMV capture**: captured against missed GMV.
* **Token burn**: the workspace's AI usage this cycle. Workspace scope only.

A board that splits by the widget's own scope is not offered. For example, an ad account widget offers **Scorecard**, **Ad tool mix** and **GMV capture**.

### Pick and order metrics

In the app, open the account sheet and tap **Widget metrics**. Add metrics, then hold and drag to reorder. The first is the big number, and the widget shows up to 8. Metrics past 8 are marked as web only.

This list is shared with the web: it also sets the metrics on your ad account pages at one.epsilo.ai.

### Tap the widget

* Tap the number to switch to the next metric.
* Tap the chart for the next board, or to see what drove a number. Mix boards name the biggest items and group the rest as **Others**.
* Tap the time stamp to refresh.
* Tap anywhere else to open the ad account in the app, or Portfolio.

### Add it to the Lock Screen

Long-press the Lock Screen, tap **Customize**, then **Lock Screen**, and add Epsilo to the widget row. Lock Screen widgets use the same **Edit Widget** settings.

## FAQ

> [accordion] The widget shows sample data. Why?
>
> You are signed out in the app. Open Epsilo and sign in. The widget switches to your workspace.

> [accordion] The ad account list in Edit Widget is empty.
>
> Open the app once so it can load your ad accounts, then try again.

> [accordion] Can the widget show the last 30 days?
>
> No. The widget always shows today so far, measured against the day in **Compare with**. Use Portfolio for longer ranges.

> [accordion] Why did my metrics change on the web too?
>
> **Widget metrics** is the same list your ad account pages use on the web. Changing it in one place changes both.

## Related

> [card] [Install and sign in](https://epsilo.ai/docs/ios/install-and-sign-in.md)
>
> The widget needs you signed in.

> [card] [Notifications and Live Activities](https://epsilo.ai/docs/ios/notifications-and-live-activities.md)
>
> Alerts and live progress on the Lock Screen.

> [card] [Epsilo for iPhone and iPad](https://epsilo.ai/docs/ios/overview.md)
>
> Everything the app does.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.