White-Label Reports

Overview

White-label reports are a Cloud Studio feature that lets you generate professional, branded maintenance reports for your clients. Each report aggregates audit log data, approval activity, snapshot history, and policy enforcement metrics from one or more connected WordPress sites into a single, polished document.

Reports are designed to demonstrate the value of your maintenance work. Instead of telling clients "we kept your site safe this month," you can show them exactly what happened: how many events were logged, which actions were blocked by policies, how many approval requests were processed, and when snapshots were taken.

Every report is fully white-labeled. Your agency's name, logo, and brand colors appear throughout the document — AdminLocks branding is never visible to your clients.

Report Types

AdminLocks Cloud supports three report types, each tailored for a different use case:

You can generate any report type for any time period. The report type determines which data is emphasized and how the information is organized, but all types draw from the same underlying audit log and site metadata.

Generating a Report

To generate a report from the Cloud dashboard:

1. Navigate to Reports in the Cloud sidebar
2. Click New Report
3. Select the report type: maintenance, security, or activity
4. Choose the time period — weekly, monthly, or a custom date range
5. Select which sites to include (one or more)
6. Click Generate

Report generation typically takes a few seconds. Cloud fetches the relevant data from each selected site's synced audit log, aggregates it, applies your branding settings, and produces the report. The finished report transitions to a generated status and is available for download or sending.

Report Statuses

The report data is stored as JSON in the Cloud database, making it fast to re-render with different branding or to query for historical trends. The rendered output can be downloaded as a PDF or shared via a secure link.

Multi-Site Reports

One of the most powerful aspects of white-label reports is multi-site aggregation. If you manage multiple WordPress sites for the same client, you can include all of them in a single report.

The Cloud data model uses a ReportSite join table that links reports to specific sites. When a report covers multiple sites, each site's data is presented in its own section with site-specific metrics, followed by a combined summary section.

For example, a monthly maintenance report for a client with three sites might show:

• Site A (example-store.com) — 234 events, 3 plugin updates, 1 snapshot, 12 blocked actions
• Site B (example-blog.com) — 87 events, 2 plugin updates, 1 snapshot, 4 blocked actions
• Site C (example-corporate.com) — 156 events, 5 plugin updates, 2 snapshots, 8 blocked actions
• Combined Summary — 477 total events across 3 sites, 10 updates performed, 4 snapshots taken, 24 actions blocked by policy

Branding

Report branding is configured at the team level in Cloud settings. Once set, your branding applies to all reports generated by your team.

Branding Settings

To configure branding, go to Settings in the Cloud dashboard and select the Branding tab. Changes take effect immediately for all newly generated reports. Previously generated reports retain the branding that was active at the time of generation.

// Branding settings data model
{
  "companyName": "Acme Digital Agency",
  "logoUrl": "https://acme.agency/logo.png",
  "primaryColor": "#2563EB",
  "surfaceColor": "#F8FAFC",
  "bgColor": "#FFFFFF"
}

Scheduling

Instead of generating reports manually each week or month, you can set up scheduled reports that are created automatically. Scheduled reports use a cron endpoint in Cloud that runs on a configurable interval.

Setting Up a Schedule

1. Navigate to Reports in the Cloud dashboard
2. Click Schedules at the top of the page
3. Click New Schedule
4. Configure the schedule:
   • Report type — maintenance, security, or activity
   • Frequency — weekly (generated every Monday) or monthly (generated on the 1st)
   • Sites — select which sites to include
   • Auto-send — optionally email the report to the client on generation
5. Click Save Schedule

When a scheduled report is due, Cloud creates a report record with status scheduled, generates the report data, transitions it to generated, and optionally sends it to the configured recipients (transitioning to sent).

Scheduled reports cover the period since the last report was generated. For weekly schedules, each report covers the previous 7 days. For monthly schedules, each report covers the previous calendar month.