DataStated Documentation Add my site
Add my site

Periods and charts

Money totals, charts and breakdowns use USD only, with no currency conversion. Order counts include all currencies. The reporting-scope note lists excluded money records and their amounts by currency; records with unknown currency have no usable monetary total. Do not read a USD total as your business's combined revenue across currencies.

The dashboard describes one stretch of time. This page lists the periods you can pick, the URL that names each one, how the chart buckets that time, and when each headline tile shows up.

Periods

The period menu has ten presets. Each one ends on today except Yesterday and Last month, and the key in the second column is what a shared link carries as ?period=:

today        Today
yesterday    Yesterday
7d           Last 7 days
30d          Last 30 days
90d          Last 90 days
month        This month (the 1st through today)
last-month   Last month
ytd          Year to date
12m          Last 12 months
all          All time (bounded to the most recent 1,830 days)

Custom picks exact days and the URL carries them as ?from=2026-08-01&to=2026-08-31, both inclusive. A valid period wins over from and to when a link has both. Anything malformed, inverted, or an all for a site with no data yet falls back to the last 30 days, so a bad link never breaks the page. The previous and next arrows shift the window by its own length, and the next arrow never moves the window past today.

A dashboard window spans at most 1,830 days. A larger All time or custom request shows its most recent 1,830 days with a notice; choose an earlier custom range for older retained history. The API rejects oversized ranges, and a timeseries request may contain at most 2,000 points.

Hourly, daily, weekly

The chart draws one point per bucket. Without a choice the bucket follows the range: up to two days is drawn by the hour, up to 92 days by the day, longer by the week. ?grain=hour, day or week overrides that, within limits: hours are offered only for ranges up to two days (a month of hours is 720 points of noise), weeks only from 14 days (one bucket is not a series), days always. A hand-typed grain outside those limits falls back to the automatic pick. The toggle appears only when the range can be drawn more than one way, and the URL carries grain only when it differs from the automatic pick, so shared links stay short.

Buckets are anchored at the range's first UTC midnight and step by the grain, so a weekly series of the previous period lines up bucket for bucket with this one. The last bucket is clipped to the end of the range and can be shorter. The bucket that contains right now is drawn dashed and labelled "Today so far", "This hour so far" or "This week so far", because it is still being written.

Visitors are unique per bucket: someone active on Monday and Tuesday counts once in each day, and once in the period total. A bucket where a ratio cannot be computed (a day with no visitors, for conversion rate) is a gap in the line, not a zero.

The previous period

The dashed line behind the chart is the same metric for the stretch of time immediately before this one, the same length. Last 7 days compares with the 7 days before those; This month compares with the same number of days before the 1st. Hover any point to see both figures and the change between them. The line is on by default; ?compare=off hides it. The toggle only renders when a previous period exists to draw.

The deltas on the tiles read against the same previous period, from the events themselves rather than a sum of the daily points, because a returning visitor counts once per day in the series but once per period in a total.

The drawn metric

Clicking a tile switches the chart to that metric and the URL carries it as ?metric=:

visitors  pageviews  orders  revenue
conversion  revenuePerVisitor  netRevenue  newVisitors  avgVisit  bounceRate

An unknown value reads as visitors. mrr is a tile but not a chart metric (see below).

Headline tiles and when they hide

Visitors, pageviews, orders and revenue are always there. Every other tile exists only when its number can be counted from the records. A number the records do not support is left out rather than shown as zero.

  • Conversion rate: orders divided by visitors. Hidden when the period has no visitors to divide by.
  • Revenue per visitor: revenue divided by visitors. Hidden with no visitors.
  • Net revenue: revenue minus refunds and lost disputes, with the line under the number saying what was taken back and what is held in an open dispute. Hidden unless something was refunded, lost to a dispute or held in an open dispute, in this period or the one before, since a net equal to gross is the revenue tile said twice.
  • Monthly recurring: MRR at the period end, using the latest Stripe subscription observation available by that time, capped at now for a current period. It is hidden under a visitor filter or when observation coverage or supported USD pricing is missing. Later price changes are not applied backwards to older periods. It is a point-in-time total, so it has no chart and is not clickable. See MRR coverage and limits.
  • New visitors: people on their first ever visit, with the returning count underneath. Hidden when visitors were recorded but none carried a visit number.
  • Average visit: mean on-screen time of the visits the tag could time. Hidden when no visit in the period was timed.
  • Bounce rate: the share of timed visits that saw one page for under ten seconds. Hidden with no timed visit. A rise is coloured as a step backwards.

Each tile has a small "i" beside it with the same explanation in the dashboard.

Questions? Email us at hello@datastated.com.