Audit results in Preflight
When the audits complete, Preflight displays the results in the readiness dashboard. The dashboard shows an overall readiness meter and the opportunities it found, grouped by audit category. Within each category, individual audits identify specific items to review or fix.
Toolbar
The toolbar at the top of the readiness dashboard provides actions for the current run:
- Reanalyze – Start a brand-new audit run on the current page. Reanalyze always discards the displayed results and runs every audit again, so use it whenever you want fresh results — for example, after editing the page. Reanalyze is in the More actions (…) menu.
- Export – Download the current run as a CSV (spreadsheet-friendly) or PDF (a formatted document) file. Depending on your environment, select Export from the toolbar or from the More actions (…) menu.
When you export, you can also choose what to include:
- Include metadata table – Add a table of run details, such as the host, content path, and generation details.
- Include passed audits – Include the audits that passed with no opportunities, not only the opportunities that were found.
Readiness meter
At the top of the dashboard, the readiness meter reflects the overall audit results. It shows a readiness score as a percentage, based on the proportion of audits that finished without opportunities, along with the total number of opportunities found across all audits. The readiness meter helps you gauge overall page health at a glance.
When you are viewing a run that was reloaded from a previous session, the header shows how long ago it was performed — for example, yesterday. For more information, see Continue a previous session.
While the audits are still running, the readiness meter shows a progress bar with a short status beneath it that shows the current step. When the audits complete, the meter shows the final readiness percentage and opportunity count.
Audit categories
Preflight groups related audits into categories, such as SEO and Accessibility. Each category appears as a card that shows the number of opportunities found, or indicates that all its audits passed with no opportunities.
Expand a category to see its individual audits. Each audit shows whether it passed or found opportunities, a short description, and a count of the opportunities found. Select an audit that found opportunities to open its detail page.
For the complete list of audit categories and the audits in each, see Preflight audit categories.
Opportunity details
The detail page shows the opportunities the selected audit found. When the same problem occurs in more than one place, each occurrence is called an instance. Use the navigator (Previous instance and Next instance) to step through them; it shows your position, for example 1 of 5 instances found. To return to the readiness dashboard, select the back arrow beside the audit title; the dashboard reopens with the audit’s category expanded.
Each opportunity includes:
- A severity or impact badge that indicates how important the opportunity is.
- Details about the opportunity, such as a description of the problem, a recommendation, and, for accessibility, the related WCAG rule and conformance level.
- An Element section that identifies the affected element on the page, with a Highlight on page button. When the element has readable text, the section is titled Element: Text and shows that text; otherwise it is titled Element: Selector and shows the element’s CSS selector. For Links and Canonical opportunities, a Current URL section also shows the URL involved, which you can open in a new tab if possible.
- A Suggestion section with a recommended fix. When the suggestion is generated by AI, it is marked as an AI-generated suggestion, and may include a short rationale explaining the suggested fix.
Highlight on page
After the audits complete, you can quickly locate and understand an opportunity by highlighting it directly on the page.
Preflight highlights the affected element in context, connecting the result in the panel to the exact location in your content. This makes it easier to review and resolve opportunities without manually searching through the page.
- Open the Preflight panel in the context of the page to audit, and select Analyze page to run the audits.
- Select an audit from the readiness dashboard, then select an opportunity to review.
- Select Highlight on page. The preview automatically scrolls to the relevant area and highlights the corresponding element, so you can easily identify and optimize the opportunity in context.
Highlighting isn’t possible for every opportunity — for example, when an opportunity isn’t tied to a specific element, the element is hidden, or it is no longer on the page. In those cases the Highlight on page button is dimmed; hover over it to see why.
In the Universal Editor, highlighting is not yet supported for Accessibility opportunities; the Highlight on page button is dimmed, and you can hover over it to see why.
In the AEM Sites Page Editor and Adobe Managed Services (AMS), highlighting also requires Edit mode. In Preview mode, Preflight shows a Highlighting issues not available notice; switch to Edit mode to highlight elements on the page.
Job ID
Each Preflight run has a unique job ID, shown at the bottom of the panel. It is mainly useful when an administrator is troubleshooting a specific run. Hover over the ID and select the copy icon that appears to its right; the ID is copied to your clipboard and a confirmation message appears. Include this ID when you report a problem.
When you use Preflight outside the Universal Editor — for example, through the Sidekick or a bookmarklet — the panel footer also shows your organization name above the job ID. In the Universal Editor, your organization appears in the AEM header instead.