Reference

Concepts

Key terms and how they fit together.

Page Definition

A URL you want to audit, along with its name, schedule, and configuration. Every audit starts from a page definition. Each page definition belongs to an organization and has a unique ref (slug) used to identify it in the dashboard and API.

Audit

A single audit request targeting one page definition. Audits are created when triggered manually, on schedule, or via the API.

An audit is not just a single Lighthouse run. xcelera runs Lighthouse at least 3 times per audit and performs statistical analysis to select a representative result. This reduces the natural variance in Lighthouse scores and gives you a stable, trustworthy number.

Run

An individual Lighthouse execution within an audit. Each run produces raw performance data and scores. The audit selects the most representative run from the set.

Statistic

Individual metrics extracted from the representative run — Largest Contentful Paint (LCP), Total Blocking Time (TBT), Cumulative Layout Shift (CLS), and others. Statistics power the trend charts on your dashboard.

Score

The 0–100 Lighthouse score for each category: Performance, Accessibility, Best Practices, and SEO.

Credits

Each audit consumes one credit from your organization's monthly allocation. Credits reset on your billing cycle. See Usage & Billing for tier details.

Failed audits still consume a credit. Make sure your URL is reachable and responds within a reasonable time before scheduling recurring audits.

Audit lifecycle

Every audit moves through a set of states:

  1. Scheduled — queued and waiting to be picked up
  2. Running — Lighthouse is actively auditing the page
  3. Succeeded — completed, results are available
  4. Failed — something went wrong (page unreachable, timeout, etc.)
Help