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

# Badges, colours and icons

> Every badge, colour, icon and visual cue in Block Hero, screen by screen: what it means and what to do.

Block Hero uses Shopify's own badge colours, so they mean the same thing as elsewhere in your Shopify admin.

| Colour | Usually means |
| - | - |
| Green | Live, done or connected. Nothing to do. |
| Yellow | Waiting, or needs a look from you. |
| Orange | Something is overriding the normal behaviour. |
| Red | Something failed. Act on it. |
| Blue | Information only. |
| Grey | Ended, off, or a plain label. |

## Scheduler

The **Scheduler** table lists your blocks with their schedules and results.

![Scheduler: the block table with type icons in the first column, a Not published badge next to one block name, and green, yellow, orange and +2 date badges...](https://mintcdn.com/blockhero/JdEGr8CZPqTHi1ss/images/reference/scheduler-badges.png?fit=max\&auto=format\&n=JdEGr8CZPqTHi1ss\&q=85\&s=3bb7a91174b21efd45620defdc9b4d54)

Example data

### Block type icons

The first column shows an icon for each block's type. Hover over it to see the type's name.

| Icon | Hover text | Block type |
| - | - | - |
| Picture | **Image Banner** | [Image Banner](/docs/blocks/image-banner.md) |
| Play button | **Media Banner** | [Media Banner](/docs/blocks/media-banner.md) |
| Two columns | **Media Grid (2)** | [Media Grid (2)](/docs/blocks/media-grid.md) |
| Product tiles | **Collection Grid** | [Collection Grid](/docs/blocks/collection-grid.md) |
| List | **Collection List** | [Collection List](/docs/blocks/collection-list.md) |
| Section layout | **Theme section** | A connected [theme section](/docs/theme-sections/overview.md) |

### Date badges in Content schedules

Each badge is one schedule. It shows the dates in your store's time zone:

* **Oct 1-Oct 14**: starts Oct 1, ends Oct 14.
* **Oct 1+**: starts Oct 1 and has no end date.

| Badge | Colour | Meaning | What to do |
| - | - | - | - |
| Dates | Green | The schedule is live now. | Nothing. |
| Dates | Yellow | The schedule starts later. | Nothing. |
| Dates | Grey | The schedule has ended. | Nothing. |
| Dates | Orange | Content in this schedule has a status set by hand, so it ignores the dates. Hover to read **Content here is set by hand and ignores this schedule. Open the block for details.** | Open the block. See [Setting a status by hand](/docs/scheduling/statuses.md#setting-a-status-by-hand). |
| **+** and a number, such as **+2** | Grey | More schedules than fit. | Hover to see their dates. |

Which badges show:

* Every schedule that overlaps the period picked at the top of the page.
* Every upcoming schedule, whatever the period. **Last 30 days** ends yesterday, so upcoming schedules would otherwise be hidden.
* Every live schedule, whatever the period, including one that started today.
* Every orange badge, whatever the period, because the status set by hand changes your store now.

Up to two badges show. Orange badges come first, then the newest schedule by start date, so upcoming schedules come before live ones and live ones before ended ones.

### Not published

| Badge | Colour | Where | Meaning | What to do |
| - | - | - | - | - |
| **Not published** | Red | Next to the block's name on the **Scheduler** and on the block's page | Your last change didn't reach your store. Your store still shows the previous version. Your changes are saved in Block Hero. | Click **Try again** in the red banner. See [Troubleshooting publishing](/docs/troubleshooting/publishing.md). |

## Block page

![Scheduler > block page: the Enabled badge next to the block name, a schedule card with the Not saved badge, and Active and Scheduled status badges on schedules](https://mintcdn.com/blockhero/JdEGr8CZPqTHi1ss/images/reference/block-page-badges.png?fit=max\&auto=format\&n=JdEGr8CZPqTHi1ss\&q=85\&s=da5187c23cf4af7d7251badbe970cace)

| Badge | Colour | Where | Meaning | What to do |
| - | - | - | - | - |
| **Enabled** | Green | Next to the block's name | The block is on. | Nothing. |
| **Disabled** | Grey | Next to the block's name | The block is off and shows nothing on your store, whatever its schedules say. | Turn it on if you want it to show. See [Turn a block on or off](/docs/scheduling/turn-a-block-on-or-off.md). |
| **Not saved** | Yellow | Next to **Content Scheduling** | You have changes in the schedule card that aren't saved yet. | Click **Save** in the save bar, or discard. |
| **Active** | Green | On each schedule, and on each piece of content on Image Banner and Media Banner blocks | Live now. | Nothing. |
| **Scheduled** | Yellow | Same | Starts later. | Nothing. |
| **Inactive** | Grey | Same, and in the **Inactive** card | Ended, or set to **Inactive** by hand. Not on your store. | Restore it if you want it back. See [Edit, restore or delete](/docs/scheduling/edit-restore-delete.md). |
| Content name | Grey | Inside a schedule | One piece of content in that schedule. | Click it to open the content. |

See [Statuses](/docs/scheduling/statuses.md) for how Block Hero sets each status.

### Banners on the block page

| Banner | Colour | Meaning | What to do |
| - | - | - | - |
| **1 content item ignores its schedule**, or a number of items | Orange | Content has a status set by hand that beats its dates. | Click **Return to schedule**, or **Open content**. |
| **We couldn't publish your last change to your store** | Red | Your last save didn't reach your store. | Click **Try again**. |

### The Setup Guide

On a Block Hero block's page, the **Setup Guide** shows your progress.

| Cue | Meaning | What to do |
| - | - | - |
| Dashed grey circle | Step not done yet. | Do the step. Or click the circle (**Mark as done**) to tick it yourself. |
| White tick on a dark circle | Step done. | Nothing. Click it (**Mark as not done**) to undo. |
| Progress bar and **1 / 3 completed** | How many steps are done. | Nothing. |
| Grey tick and **Done** | Every step is done. | Click **Dismiss Guide**. |

See [The Setup Guide](/docs/get-started/schedule-your-first-block.md#the-setup-guide).

### Content form

| Badge | Colour | Where | Meaning | What to do |
| - | - | - | - | - |
| **Auto-filled** | Purple | Next to **Image alt text** | Block Hero filled in the alt text for you. Hover to see where it came from. | Nothing, or type your own. |

When you set a status by hand on a piece of content, a blue banner says **This content status is manually overridden.** Click **Click here** to go back to the dates, then save.

## Content during period

| Cue | Colour | Meaning | What to do |
| - | - | - | - |
| Block type icon | Grey | Same icons as the **Scheduler**. | Hover for the type. |
| Date badge | Green, yellow or grey | Live, starts later or ended, as on the **Scheduler**. | Nothing. |
| Date badge | Orange | Content in this row has a status set by hand, as on the **Scheduler**. | Open the block. See [Setting a status by hand](/docs/scheduling/statuses.md#setting-a-status-by-hand). |
| Info icon next to the dates | Grey | Hover to read **This content schedule extends beyond the selected date range. Analytics shown are only for the filtered period.** | Nothing. Widen the period to see the whole schedule. |

## Blocks page

![Blocks: the Block Hero blocks card with type icons and counts, and the Theme sections card with one section showing a Needs you badge](https://mintcdn.com/blockhero/xyXLRILs4QWwejCf/images/reference/blocks-page-badges.png?fit=max\&auto=format\&n=xyXLRILs4QWwejCf\&q=85\&s=73880cb8e535705ecbe71d87210de711)

| Cue | Colour | Meaning | What to do |
| - | - | - | - |
| Picture icon | Grey | Image Banner or Media Banner in **Block Hero blocks**. | Nothing. |
| Two columns icon | Grey | Media Grid (2), Collection Grid or Collection List in **Block Hero blocks**. | Nothing. |
| Section layout icon | Grey | A connected section in **Theme sections**. | Nothing. |
| Number on the right | None | How many blocks of that type you have. A theme section always shows 1. | Nothing. |
| No badge on a theme section | None | Connected. A badge only shows when something is wrong. | Nothing. |
| **Needs you** | Yellow | The section needs you to finish or fix something. | Open the section. See [Connection status](/docs/theme-sections/connection-status.md). |
| **Disconnected** | Grey | The section is no longer connected to Block Hero. | Nothing. See [Disconnect a theme section](/docs/theme-sections/disconnect.md). |

On a Block Hero block type's page, the title shows a grey **Block Hero block** badge, and fields and theme settings are listed as grey badges. They're labels only.

## Theme section page

![Blocks > theme section page: the Theme connection card with the Connected badge, a field with the Not scheduled badge, and Hidden in the theme editor with...](https://mintcdn.com/blockhero/JdEGr8CZPqTHi1ss/images/reference/theme-section-badges.png?fit=max\&auto=format\&n=JdEGr8CZPqTHi1ss\&q=85\&s=ed0fcb304b16cc79140da195b0dd2b21)

| Badge or cue | Colour | Where | Meaning | What to do |
| - | - | - | - | - |
| **Connected** | Green | **Theme connection** card, and the **Section** panel on the block page | The section is linked and on your live theme. | Nothing. |
| **Needs you** | Yellow | Next to the page title, the **Theme connection** card, and the **Section** panel on the block page | Some settings aren't linked, the section has gone from your live theme, or a theme update removed its links. | Follow the steps on the page. See [Connection status](/docs/theme-sections/connection-status.md). |
| **Disconnecting** | Yellow | Next to the page title and in the **Theme connection** card | You started disconnecting the section and haven't finished. | Follow the steps or banner on the page. See [Disconnect a theme section](/docs/theme-sections/disconnect.md). |
| Green tick | Green | Each step in **Finish in the theme editor** or **Unlink in the theme editor** | That step is done. | Nothing. |
| Empty circle | Grey | Same | That step isn't done yet. | Do it in the theme editor, then check again. |
| **Not scheduled** | Grey | Next to a field | The field is switched off. The theme editor's value shows. | Switch it on to schedule it. See [Choose which fields to schedule](/docs/theme-sections/choose-fields.md). |
| **Still linked to Block Hero. Unlink it in the theme editor to set it there.** | Orange text | Under a field you switched off | The field is off but still linked in your theme. | Unlink it in the theme editor. |
| Type under a field, such as **Image**, **Text**, **Link** or **Collection** | Grey text | Under each field | What kind of setting it is. | Nothing. |
| **Hidden in the theme editor** **On** | Yellow | **Section options** | The section is hidden in the theme editor, so it doesn't show on your store. | Unhide it in the theme editor if it should show. |
| **Hidden in the theme editor** **Off** | Grey | **Section options** | The section isn't hidden. | Nothing. |

When you connect a section, the review step lists each field with a grey type badge, such as **Image** or **Text**. Settings under **Stays in the theme editor** show as grey badges too. They're labels only.

### Banners on the theme section page

| Banner | Colour | What to do |
| - | - | - |
| **A theme update removed** the section's **links to Block Hero** | Orange | Click **Reconnect**, or **Stop scheduling these fields**. |
| **This section is no longer on that page of your live theme.** | Orange | Check the page in the theme editor, then **Check connection**. |
| **This section is connected to another Block Hero block on your live theme.** | Orange | Keep one block and disconnect the other. |
| **Scheduling has stopped. Delete the block to finish disconnecting** | Orange | Click **Delete block**. |
| **The theme couldn't be checked. Try again in a moment.** | Red | Wait, then **Check connection**. |

## Results and metrics

![Scheduler > block page > Performance card: a metric name with its dotted underline and tooltip, a Since note under a value, a dash with its tooltip, and the...](https://mintcdn.com/blockhero/JdEGr8CZPqTHi1ss/images/reference/metric-cues.png?fit=max\&auto=format\&n=JdEGr8CZPqTHi1ss\&q=85\&s=730bc4f3837e6ab8639a660a1fdbc0cc)

| Cue | Where | Meaning | What to do |
| - | - | - | - |
| Dotted underline under a label | Metric names on the **Performance** card and in **View report**, and **Since** and **Not counted yet** notes | Hover to see a definition or explanation. On the **Scheduler** metrics bar, hover over the name to see the same. | Hover. |
| A dash instead of a number | Any metric | No number to show: nothing to divide by (such as **CTR** with no impressions), not counted yet, or analytics couldn't load. It is not the same as 0. | Hover to see which. See [When you see a dash](/docs/results/metrics.md#when-you-see-a-dash). |
| **0** | Any metric | Block Hero was counting and nothing happened. | Nothing. |
| **Since** and a date, such as **Since Oct 4** | Next to a number | Block Hero started counting this metric on that day. Earlier days in your period aren't counted. | Hover for details. See [When counting starts](/docs/results/when-counting-starts.md). |
| **Not counted yet** | Next to a metric | Block Hero hasn't started counting it for your store. | Hover to see what starts it. |
| Blue note under a table or report | Under **Content during period**, the **Performance** card or a report | Lists start dates or metrics not counted yet. | Nothing, or turn on the app embed. |
| Grey bars in place of numbers | Anywhere numbers load | Still loading. | Wait a moment. |
| **Section Header** row | Block reports for theme sections | The section's own heading or text above its cards, counted on its own row. | Nothing. |

If analytics can't load, a dash shows with **Analytics are temporarily unavailable. Content is unaffected.** on hover. Your schedules keep running.

## Plans

| Badge | Colour | Where | Meaning | What to do |
| - | - | - | - | - |
| **Active** | Green | **Current plan** card | Your plan is active. | Nothing. |
| **Trial ends** and a date, or **Trial** | Blue | **Current plan** card | You're on your free trial. | Nothing. |
| **Pending approval** | Yellow | **Current plan** card | The charge is waiting for your approval in Shopify. | Click **Choose plan** and approve it. |
| **Paused** | Orange | **Current plan** card | Shopify paused billing because your store is frozen. | Nothing. It resumes when your store is reactivated. |
| **Cancelled** | Red | **Current plan** card | Your subscription was cancelled. | Choose a plan. |
| **Complimentary** | Blue | **Current plan** card | Free access. Nothing is billed. | Nothing. |
| **Unmatched subscription** | Orange | **Current plan** card | Your Shopify subscription isn't linked to a Block Hero plan yet. Your features are unaffected. | Nothing. Contact us with questions. |
| **No plan** | Grey | **Current plan** card | No plan yet. | Choose a plan. |
| **Test** | Grey | Next to the status | A test charge. | Nothing. |
| **Current** | Green | A plan card | The plan you're on. | Nothing. |
| **Private** | Blue | A plan card | A plan offered only to your store. | Nothing. |

See [Subscription status](/docs/billing/subscription-status.md).

## Banner colours

Banners appear at the top of a page or card.

| Colour | Kind | Examples |
| - | - | - |
| Red | Something failed. Act on it. | **We couldn't publish your last change to your store**, **Couldn't load billing**, **This theme section couldn't be loaded** |
| Orange | Something needs your attention or is overriding the normal behaviour. | **1 content item ignores its schedule**, **Choose a plan to keep using Block Hero**, **Your subscription is paused**, **The charge wasn't approved** |
| Blue | Information. Nothing is wrong. | **Your free trial ends in** a number of days, **Confirming your subscription with Shopify…**, start dates under a report |

## Related

> **[Glossary](/docs/reference/glossary.md)**
>
> What each term in Block Hero means.

> **[Limits at a glance](/docs/reference/limits.md)**
>
> Limits, time zones and timings.


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