> For the complete documentation index, see [llms.txt](https://revhero.gitbook.io/revhero-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://revhero.gitbook.io/revhero-docs/your-hotels-performance/dashboard/widget-anatomy.md).

# Reading a widget

Every Dashboard widget uses the same layout. Learn it once and you can read all of them.

A **widget** is one card on the Dashboard that reports one metric. Every widget uses the same layout. Once you can read one widget, you can read all of them. A widget that breaks the pattern, with no chart or no comparison figure, is worth a second look.

![The parts of a widget](https://272652298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnzEa7YGji6t92Mfc0ZJ1%2Fuploads%2Fgit-blob-51299edcd21132bfc0e5226fa3f687b960849e0e%2Fthe-parts-of-a-widget.svg?alt=media)

*The same seven parts sit in the same places on every widget.*

## 1. The title row

| Element                       | What it is                                                              |
| ----------------------------- | ----------------------------------------------------------------------- |
| Title (for example `Revenue`) | The metric the widget covers                                            |
| `ⓘ` icon                      | Hold your pointer over it to see that metric's definition               |
| ⤢ icon, top right             | Expands the widget to the full view. The same corner collapses it again |

The `ⓘ` tooltip works the same way in the collapsed card and in the expanded view.

## 2. The headline number

The headline is a large purple figure. It is the current value for the period you chose in the filter bar. Examples: Revenue `181,273.50€`, Occupancy `84.10%`, ADR `205.29€`, Room Nights `883`.

The comparisons sit beside the headline. Each one pairs a figure with a coloured percentage figure. **Green means up. Red means down.**

| Comparison    | What it means                                                                                   | Example                          |
| ------------- | ----------------------------------------------------------------------------------------------- | -------------------------------- |
| **VS STLY**   | STLY means Same Time Last Year. It is the value at the same point in last year's booking window | `VS STLY 164,601.16€` `↑10.13%`  |
| **LY Actual** | LY means Last Year. It is the value last year finally reached for the same period               | `LY Actual 168,043.14€` `↑7.87%` |

Expand a single-metric widget and a third comparison appears: **Forecasting**, the projected close for the period. The **Reference Date** appears in the top right of the expanded view.

Not every widget carries every comparison. [Revenue](/revhero-docs/your-hotels-performance/dashboard/revenue.md), [Occupancy](/revhero-docs/your-hotels-performance/dashboard/occupancy.md), [RevPAR](/revhero-docs/your-hotels-performance/dashboard/revpar.md), [ADR](/revhero-docs/your-hotels-performance/dashboard/adr.md) and [Room Nights](/revhero-docs/your-hotels-performance/dashboard/room-nights.md) carry all of them. [Pickup](/revhero-docs/your-hotels-performance/dashboard/pickup.md) and [Booking Pace](/revhero-docs/your-hotels-performance/dashboard/booking-pace.md) compare against STLY only.

## 3. The as-of day

The **Reference Date** is the day the figures are reported as of. You set it once, in the filter bar, for the whole screen. You cannot set it for a single widget. See [Reference Date](/revhero-docs/your-hotels-performance/dashboard/reference-date.md).

## 4. The budget bar

Where you set a target, a horizontal bar shows your progress towards it. The attainment percentage sits beside the bar. For example, `Budget: 135,000.00€` at `134.28%`. Attainment can go above 100%.

Where you set no target, a purple underlined **Add budget** link sits in place of the bar. This is the normal empty state, not a fault. Click the link to set targets in [Budget & Target](/revhero-docs/your-hotels-performance/budget-target.md).

## 5. Online Market Share

Two widgets also show your share of online demand for the period: [Revenue](/revhero-docs/your-hotels-performance/dashboard/revenue.md) and [Room Nights](/revhero-docs/your-hotels-performance/dashboard/room-nights.md). **CY** means current year, for example `CY 9.51%`. **LY** means the same point last year, for example `LY 9.95%`. Green means you are ahead of last year. Grey means flat. Red means behind.

## 6. The chart

Most widgets draw 2 lines. **Purple** is the current period. **Teal** is STLY. A **pink dashed** line adds the forecast over future dates, where forecasting applies.

The single-metric widgets change chart shape with the length of the period.

| Period length                     | Chart                                                                                                   |
| --------------------------------- | ------------------------------------------------------------------------------------------------------- |
| A full month, or any longer range | A line chart                                                                                            |
| A short range of only a few days  | Paired bars: a purple current-period bar beside a teal STLY bar, for each day. There is no forecast bar |

You get the short range when you pick a custom period near the end of the month. The comparison figures are the same in both chart shapes.

Some widgets use their own shape.

| Widget                                                                                                  | Chart                                                                            |
| ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| [Business Mix](/revhero-docs/your-hotels-performance/dashboard/business-mix.md)                         | A pie with a legend, plus a table view                                           |
| [Online Demand — Per Day](/revhero-docs/your-hotels-performance/dashboard/online-demand-per-day.md)     | Two stacked area charts, with a **Stay dates** / **Search dates** toggle         |
| [Online Demand — Overall](/revhero-docs/your-hotels-performance/dashboard/online-demand-overall.md)     | Bars for each country, with a hotel-against-market readout                       |
| [Competitor Rate Analysis](/revhero-docs/your-hotels-performance/dashboard/competitor-rate-analysis.md) | One line for each property, with **Source**, **Room Type** and **LOS** dropdowns |
| [Rate Recommendation](/revhero-docs/your-hotels-performance/dashboard/rate-recommendation.md)           | A calendar of day tiles, with a **Yield Rates** link                             |
| [Pickup](/revhero-docs/your-hotels-performance/dashboard/pickup.md)                                     | An area chart split above and below zero                                         |

Hold your pointer over any point or bar to see a tooltip with that day's figures. In the expanded view, a vertical guide line drops at that date, so the numbers are clearly tied to one day. Tooltips are read-only.

## 7. The freshness stamps

The Dashboard reports its freshness in the context line at the top, as **Last Upd.**, with the date and time. Where a widget also carries a forecast, it shows a second stamp: **Forecasting: Last Upd.**. The 2 stamps can show different times.

{% hint style="info" %}
Data that has not refreshed is the most common reason a Dashboard looks wrong. Check **Last Upd.** first, and email **<support@revhero.com>** if it is not current.
{% endhint %}

## Reading a widget in 5 steps

1. **Read the title row.** Hold your pointer over the `ⓘ` icon if you are unsure what the metric means.
2. **Read the headline.** The large number is where you are. The figures tell you the direction.
3. **Check the budget bar.** Halfway through the period, 50% attainment means you are on pace. 80% means you are ahead.
4. **Read the chart.** It tells you which stay dates are driving the headline.
5. **Use the widget's own controls.** [Pickup](/revhero-docs/your-hotels-performance/dashboard/pickup.md) and [Booking Pace](/revhero-docs/your-hotels-performance/dashboard/booking-pace.md) have metric tabs. [Business Mix](/revhero-docs/your-hotels-performance/dashboard/business-mix.md) has a metric dropdown. The demand widgets have date toggles. [Competitor Rate Analysis](/revhero-docs/your-hotels-performance/dashboard/competitor-rate-analysis.md) has 3 dropdowns.

## If something looks wrong

| What you see                       | Usual cause                                             | What to do                                                                           |
| ---------------------------------- | ------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| No chart                           | The period holds no data, or the filters are too narrow | Clear the filters and check the period                                               |
| A comparison figure shows `—`      | Less than 12 months of history                          | Use the budget bar as your comparison until you have a full year                     |
| **Last Upd.** is not current       | Your booking data has not arrived                       | Email <support@revhero.com>                                                          |
| No budget bar, only **Add budget** | You set no target for that metric                       | Set one in [Budget & Target](/revhero-docs/your-hotels-performance/budget-target.md) |

## Related

* [Dashboard](/revhero-docs/your-hotels-performance/dashboard.md)
* [Reference Date](/revhero-docs/your-hotels-performance/dashboard/reference-date.md)
* [Budget & Target](/revhero-docs/your-hotels-performance/budget-target.md)
* [Glossary](/revhero-docs/support/glossary.md)

***

**Was this page helpful?** If something here is wrong, unclear or missing, email [support@revhero.com](mailto:support@revhero.com?subject=Manual%20feedback%20%5Ben%5D%20dashboard%2Fwidget-anatomy.md) and quote this page: `dashboard/widget-anatomy.md`. Say what you expected to find — that is the part we can fix.