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

# CSAT (top-box %)

> Share of Gorgias CSAT scores that are 4 or 5.

| Contract           | Value              |
| ------------------ | ------------------ |
| Metric key         | `gorgias.csat_pct` |
| Source             | Gorgias            |
| Status             | active             |
| Type               | derived            |
| Semantic version   | 1                  |
| Catalog visibility | Picker-eligible    |

## How it's calculated

```text theme={null}
100 * count(gorgias.csat_score >= 4) / nullif(count(gorgias.csat_score), 0)
```

### Built from

* `gorgias.csat_score`

## Known caveats

* Derived ratio; never average period percentages.

## Where this appears

* Ticket Volume and CSAT widget
* Dashboard builder

<AccordionGroup>
  <Accordion title="Grain and identity" icon="ruler">
    derived\_period; entity: ticket; same-day fold: sum; additivity: non\_additive.

    **Join and identity keys:** none.
  </Accordion>

  <Accordion title="Filters and boundaries" icon="filter">
    * Organization and store are resolved from the authenticated connection.
    * Reads use a half-open interval: recorded\_at >= start and recorded\_at \< end.
    * No channel or ticket-status filter is applied unless the requesting surface explicitly adds one.
  </Accordion>

  <Accordion title="Timezone, currency, and freshness" icon="clock">
    **Timezone.** Provider event timestamps are stored as instants and grouped into UTC date windows by current dashboard reads.

    **Currency.** Not applicable.

    **Freshness.** Computed by Cube at read time.
  </Accordion>

  <Accordion title="Version history" icon="clock-rotate-left">
    | Date       | Change                                                         |
    | ---------- | -------------------------------------------------------------- |
    | 2026-08-03 | Bound the metric to the executable certified semantic release. |
    | 2026-07-27 | Registered support metric contracts in the semantic catalog.   |
  </Accordion>
</AccordionGroup>