Reporting and Upkeep

Writing an Audit Report Others Can Act On

How to structure website audit findings so the reader knows what is wrong, why it matters and what to fix first, with a clear layout and honest wording.

On this page
  1. A report is a tool for action
  2. Know who is reading
  3. A structure that works
  4. Write each finding the same way
  5. Prioritize, and show your reasoning
  6. Use plain, calibrated language
  7. Use visuals sparingly
  8. Include a way to measure results
  9. Before you send it

A report is a tool for action

Most audit reports fail for the same reason: they record what the auditor did instead of helping the reader decide what to do. A forty-page export of every warning is accurate, and almost useless. A good report answers four questions fast: how is the site doing, what are the main problems, what should be fixed first, and how will we know it worked?

Writing with that purpose in mind changes what you include and how you order it.

Know who is reading

Different readers need different things.

  • An owner or manager wants a short summary, the decisions required and the cost or risk.
  • A developer wants exact addresses, steps to reproduce a problem and the expected behavior.
  • An editor or writer wants a list of pages and the changes needed, in plain language.
  • A future you wants to know what was checked, when, and what was found.

If one report must serve several readers, put the short material first and the detail in labeled sections or an appendix, so each person can stop reading when they have what they need.

A structure that works

A report that follows this order is easy to scan:

  1. Summary. Half a page at most. State the scope, the overall impression and the top three to five issues, written for someone who will read nothing else.
  2. Scope and method. What was reviewed, what was not, the date, and what information was available. Being plain about the audit scope prevents the reader from assuming you checked more than you did.
  3. Priority actions. The ordered list of what to do, with the reasoning. This is the heart of the report.
  4. Detailed findings. Each issue with evidence, grouped by theme: crawling and indexing, content, speed, mobile use, links, security.
  5. What is working. A short list of strengths, which helps readers know what to protect during changes.
  6. Open questions and limits. What you could not verify or are unsure about.
  7. Appendix. Long lists of URLs, exports and screenshots.

Write each finding the same way

Consistency makes a long report easier to read. A good pattern for each finding:

  • Title: a short statement of the problem, such as “Several service pages share the same title.”
  • Where: the pages or sections affected, with a count and a few examples. For long lists, put the rest in the appendix.
  • Why it matters: one or two sentences explaining the effect on visitors or search engines, with appropriate hedging.
  • Evidence: how you know. A screenshot, a sample address, or the check you ran.
  • Recommendation: the specific action, written so someone could carry it out.
  • Priority: high, medium or low, together with an effort estimate.

Take the example of a finding: “Contact form fails on one phone browser.” Where: contact page. Why it matters: visitors may be unable to reach the business. Evidence: the test submission did not arrive. Recommendation: have the developer check the form on that browser. Priority: high, low effort. A reader can act on that without a meeting.

Prioritize, and show your reasoning

An unordered list of problems forces the reader to do your job. Rank findings by impact and effort, group the quick wins at the top, and mark the larger projects separately. Make the logic visible, so the reader can disagree intelligently: “High because it affects every product page.” Do not inflate everything to high. If all items are urgent, none is.

Use plain, calibrated language

  • Avoid unexplained jargon. If a term is needed, define it once in a sentence.
  • Separate facts from judgments. “Forty-one pages return an error” is a fact; “this probably harms visibility” is a judgment, and should be worded as one.
  • Hedge honestly. Search engines change, and no audit can promise rankings or traffic. Say “likely to help” or “may reduce” when that is the truth.
  • Avoid blame. Describe the issue and the fix, not who caused it.
  • Be specific. “Improve page speed” is a wish. “Compress the three home page images over a megabyte” is an instruction. (Sizes in examples such as this should come from your actual checks.)
  • Do not pad. Remove findings that are trivial, duplicate or beyond your remit, or move them to the appendix.

Use visuals sparingly

A few simple elements aid understanding: a table of priority actions, a screenshot showing the problem, a small chart for a trend that matters. A page of dashboards with no commentary does not help. Every chart should have a title that states the point and a note on what to take from it.

Include a way to measure results

Say how success will be judged: which numbers or checks will be reviewed, when, and what you would expect to see. Also say what would be a reason to rethink. This ties the report to later reporting, makes it easier to separate fixes that worked from ones that did not, and encourages realistic expectations. Remember also to note which results may be slow or hard to attribute.

Before you send it

  • Read the summary alone. Does it make sense without the rest?
  • Check that every recommendation could be handed to someone and carried out.
  • Confirm that the numbers, counts and addresses are accurate and that the dates are right.
  • Ask someone unfamiliar with the audit to read the first page and tell you what they would do next.
  • Make clear how to ask questions, and offer to walk the reader through it.

A report that people act on is worth more than a thorough one they never finish. Keep the first page short, the priorities clear, and the claims modest.

The complete guide to reporting and upkeep

Reporting and Ongoing Site Maintenance
Read the guide

Keep exploring

Guides from other topics

All topics →