Skip to content
SteadyPress
Home SiteReview documentation Settings reference

Settings reference

SiteReview settings live on a single tab inside SteadyPress > SiteReview, organized into clearly labeled sections. Changes save automatically with a short debounce — there is no global Save button.

API integrations

Google PageSpeed Insights API key

Required for the Performance, Mobile Friendly, and parts of the SEO sections. Without a key, PSI calls go against Google's shared anonymous quota and immediately fail with HTTP 429.

  • Input field. Enter your Google PageSpeed Insights API key. After save, the field is masked to ••••••••••••XXXX where XXXX is the last four characters. The full key is never displayed again. Click Replace key to enter a new value.
  • Test connection button. Makes a single PSI call against your homepage and reports success or failure.
  • Status indicator. Not configured, Configured, or Failed last call.

Default: empty. The plugin will not run scans of the Performance, Mobile, or SEO sections at full quality until this is set.

Gotcha: a free Google API key gives you 25,000 PageSpeed Insights queries per day. A single SiteReview scan uses up to 12 queries (up to 6 pages × 2 strategies). Hitting the daily quota across many scans degrades subsequent scans until the quota resets.

Defaults

Default page selection

Either Homepage only or Homepage + inside pages. Controls which option is pre-selected on the New Scan view.

Default: Homepage only.

Single-file HTML filename pattern

Controls the filename when you click Download HTML from the report viewer.

  • Default: {site_domain}-site-review-{date_iso}.html
  • Available placeholders:
    – {site_domain} — your site host with dots replaced by hyphens
    – {site_name} — lowercased site title with spaces replaced by hyphens, alphanumeric only
    – {date_iso} — YYYY-MM-DD
    – {date_long} — YYYY-MM-DD-HHmm
    – {report_id} — the report's token

Sanitization runs automatically on any placeholder pulling from user-controllable data. A live preview below the field shows the resulting filename for the current site and current date.

Cleanup on uninstall

Checkbox. When enabled, uninstalling the plugin also removes the wp-content/uploads/sitereview/ directory containing every report you have generated. When disabled (the default), the directory and its files remain.

Default: unchecked.

License

SiteReview Pro license

  • License key input. Paste your Pro license key.
  • Activate button. Validates the license and unlocks Pro features on this site.
  • Status display. Shows license status (Active, Inactive, Expired), tier, expiration date, and remaining scan credits (for example, 18 of 25 credits remaining).

Each completed Pro scan consumes one credit from your account. Free scans on the same site do not consume credits.

Default: empty (Free tier active).

White-label (Pro only)

These controls appear grayed out without an active Pro license.

Agency logo upload

PNG or JPEG, maximum 200 KB, recommended dimensions ≥ 240×60 px with a transparent background. SVG is not accepted in v1 because of XSS risk on rendered output.

The uploaded image is rasterized into the report HTML as a base64 data URI.

Default: empty.

Agency name

Text field, maximum 60 characters. Used in the report header next to the logo and in the footer credit.

Default: empty.

Optional tagline

Text field, maximum 100 characters. Used as a sub-line under the agency name in the report footer.

Default: empty.

Primary color

HTML5 color picker paired with a hex text input. Applied to the rendered report's title bar, section heading underlines, and primary buttons.

Default: SteadyPress navy #21335C. A Reset to default button restores it.

Accent color

Same control pattern as Primary. Applied to recommendation card left-border accents, link color, status pill highlight ring, and chart fills.

Default: SteadyPress accent #2E5AAC. A Reset to default button restores it.

Live preview

A small preview card below the color inputs renders a sample recommendation card using the currently-selected primary and accent values. Updates live, no save required.

WCAG contrast warning

Below each color input, a small AA or AA fail badge surfaces the WCAG 2.1 contrast ratio for that color on white. Save is never blocked. The warning is informational only — agencies can ship low-contrast reports if they choose.

AI narrative tone (Pro only)

Tone preference

Single-select among three presets:

  • Direct — straightforward, factual, brief
  • Consultative — interpretive, with implication framing
  • Educational — explanatory, with more context for readers new to the topic

Influences the prompts sent to the AI on Pro narrative generation.

Default: Direct.

Privacy summary

A read-only block summarizing what data the plugin sends to which third parties:

  • Google PageSpeed Insights (Performance, Mobile Friendly, parts of SEO)
  • Mozilla HTTP Observatory (security headers grading)
  • Sucuri SiteCheck (malware and blacklist screening)
  • Public RDAP servers via rdap.org (domain registration data)
  • Public DNS (DNS records — also uses DNS-over-HTTPS as a fallback)

Plus the SteadyPress server interactions that only Pro adds:

  • AI narrative generation (executive summary, recommendations, section intros)
  • Theme analysis (only when the active theme is unrecognized and you have consented)

Links to steadypress.ai/privacy for the full policy.

Per-theme-version consent for AI theme analysis. The plugin remembers each theme version you have approved or skipped. Use the Revoke consent affordance against a specific theme version to clear the stored choice — the next scan will re-prompt before sending theme source.

Onboarding

Replay onboarding

Re-opens the first-run onboarding modal walking you through getting a Google PageSpeed Insights API key. Useful if you skipped onboarding originally or want to reference the screenshots later.

About sub-page

A small About sub-page is reachable from a link in the admin footer (SiteReview · About). It is informational and contains no controls:

  1. Version block. Plugin version, last update check timestamp, link to the changelog.
  2. Bundled data attributions. Required by license terms — GeoLite2 from MaxMind (CC BY-SA 4.0), Public Suffix List (MPL 2.0), axe-core (MPL 2.0).
  3. Open-source acknowledgements. Links to WordPress, Action Scheduler, and the steadypress/ui package.
  4. Support link. Outbound link to the SteadyPress support contact form.

Developer-only constants

These are not exposed in the admin UI. Set them in wp-config.php only when debugging:

  • WP_DEBUG_LOG — enables plugin log output to wp-content/debug.log.
  • SITEREVIEW_DEBUG — custom constant. Enables extra-verbose logging including request and response payloads. Do not set in production.

Need more help? Contact support.