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.

All time is offered once the site has data. 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. Hourly is also withheld when the range includes imported daily history, which has no hours. 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 midnight in the site's time zone and step by the grain (so a daylight-saving day has 23 or 25 hourly buckets), 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=. pageviews and newVisitors have no tile but still draw the chart from a link:

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

Seven tiles always show, reading 0 when the dates hold nothing: Visitors, Revenue, Orders, Conversion rate, Revenue per visitor, Bounce rate and Session time. Net revenue and Monthly recurring appear only when their records exist. On the chart, a bucket with nothing to divide by or nothing timed is a gap, not a zero.

  • Conversion rate: orders divided by visitors.
  • Revenue per visitor: revenue divided by 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.
  • Session time: mean on-screen time of the visits the tag could time.
  • Bounce rate: the share of timed visits that saw one page for under ten seconds. 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.