Documentation

Setup & everyday use.

Everything below reflects the current release (v1.2.0). Install to first branded pricing report is typically under ten minutes.

Before you start

You need WordPress 6.0+ on PHP 7.4+, an administrator login, and the plugin zip plus licence key from your purchase email. The scan reads the site only — it never changes your content or settings.

Setup, step by step

  1. Install the plugin

    In wp-admin go to Plugins → Add New → Upload Plugin, choose the zip from your purchase email, install and activate. It adds a Complexity Score item to your admin menu.

  2. Enter your licence key

    Open the plugin and paste the key from your purchase email. Keys are domain-based — no account, no phoning home.

  3. Read the score

    The dial shows the site's current 0–100 complexity score and band (Simple / Moderate / Complex / Very complex), with a full per-dimension breakdown underneath. The scan is instant and reads only the site itself.

  4. Set your price bands

    Under Branding, recipients & price bands, enter a support tier for each band to match your rate card. The recommended tier then shows on the dial and in the review paragraph.

  5. Add your branding

    Set your agency name, logo, brand colour and footer line, and the recipient emails for the report. These drive both the PDF and the email.

  6. Report or email

    Use Preview report for a print-ready branded PDF, or Email report to send the same assessment as a formatted message. Both carry the score, tier, movers, breakdown and history.

Everyday use

The screens you'll actually live in.

The score dial

Your live 0–100 score with its band and the recommended support tier. The meter and colour tell you at a glance where the site sits.

The dimension breakdown

All twelve inputs scored 0–10 with a short detail line each — plugins, custom code, commerce, integrations, cron, database, users, multisite, CPTs, PHP compatibility, update backlog. The honest answer to "why is it complex?"

Monthly history

A snapshot is stored once per calendar month automatically; you can also record one on demand. The bar chart shows the trend so growth is visible.

Movers & delta

Compared against the oldest stored month, the biggest per-dimension movers appear as chips and the headline delta names the shift — the case for a price review, made for you.

Price bands

Four editable tiers mapped to the score bands. The current score picks a tier and it flows into the review paragraph automatically.

Reports & email

A branded print-ready PDF (score, tier, movers, breakdown, history) and an email-safe branded message to your saved recipients — ready to attach to a renewal proposal or send straight to the client.

Get WP Complexity Score Read the FAQ