Using FooGallery Media Audit

FooGallery Media Audit checks saved galleries and the WordPress Media Library for broken image references, missing files, oversized source images, alt-text issues, thumbnail upscaling, and gallery configuration that may deserve attention. It is included with FooGallery Free and is enabled by default.

The audit is a review tool, not an automatic repair tool. It shows what FooGallery checked, identifies affected images and galleries, and suggests a next step. You decide which findings need a change.

Before you start

• You need to be a WordPress administrator, or have the manage_options capability.
• Media Audit must be active under FooGallery > Features. It is a bundled Free feature and is active by default.
• The site-wide audit reviews every saved FooGallery, including draft and private galleries, plus image attachments in the Media Library. Trashed galleries and images are excluded.

Run a Media Audit

1. In WordPress, go to FooGallery > Media Audit.
2. Select Start audit.
3. Leave the page open if you want to watch the live progress. FooGallery first checks galleries and their images, then checks image sources in the Media Library.
4. When the background audit finishes, the new report appears automatically. A page refresh is not required.

Temporary connection interruptions do not restart the audit. Live updates retry automatically, and you can use Retry now if needed. If a new audit cannot produce a report, FooGallery keeps showing the last successfully saved report when one exists.

Read the summary

The report starts with six summary tiles:

• To fix: broken or missing resources recorded as errors.
• Worth improving: warnings that may affect image delivery and should be investigated.
• Review suggestions: informational accessibility, storage, delivery, or configuration observations.
• Checks passed: rules that completed their known population without recording a finding.
• Galleries checked and Images checked: the populations assessed during this saved run.

The same image can appear in more than one finding. For example, a large source image can also have missing alt text.

Review findings and affected images

Each finding panel shows its rule code, severity, number of findings, affected image and gallery counts, coverage, and a practical fix. Select View affected images to open the finding details.

The details dialog lists up to 25 image and gallery contexts per page. When your account can edit a subject, its title links directly to the relevant Media Library item or gallery. A sampled image URL is shown for the HTTP checks that recorded one. If the site changes while the dialog is open, use Load latest findings so the list and report stay in sync.

For the exact meaning and remedy for every rule, use the FooGallery Media Audit Findings Reference.

Understand outcomes and coverage

Open All checks and coverage to see every registered check. A rule can have one of these outcomes:

• Passed: the check assessed its complete known population and found no issue.
• Findings: one or more observations matched the rule. The check can still have limited coverage.
• Incomplete: FooGallery assessed part of the applicable population but could not complete it.
• Unavailable: the audit could not make a supported assessment.
• Not applicable: there was no applicable population, or the selected gallery layout does not support that check.

Coverage always describes the saved audit run. It is not recalculated while you view the report. If gallery settings or content change after the audit, FooGallery shows a notice and you should run another audit.

Why coverage can be limited

A partial or unavailable check does not mean that the unchecked items passed. Coverage can be limited when:

• a dynamic gallery source cannot provide a bounded list of images;
• an image URL or attachment metadata cannot be verified;
• the audit reaches its image, request, or execution limits;
• site content changes before the background audit finishes; or
• a check needs rendered browser information that the current server-side audit cannot verify.

These limitations are attached only to the affected checks where possible. For example, an unavailable gallery source does not erase the independent Media Library source-image checks.

Interpret the results carefully

• Accessibility findings are review suggestions. A decorative image may correctly have empty alt text.
• Large source-image findings describe source storage. They do not measure the image bytes downloaded by a visitor.
• HTTP checks are bounded samples. They do not test every image request in every browser.
• A finding is not changed automatically. Make the appropriate edit, then run a new audit to verify the result.

Download or delete the report

Select Download report to save the detailed JSON report for support or your own records. Select Delete report to remove the saved report and in-progress audit data from WordPress.

Media Audit stores its detailed report privately in your WordPress database and does not require FooGallery Improve consent. Audit findings, image IDs, URLs, filenames, alt text, captions, and gallery details are not included in FooGallery feature-usage reports. If you separately opt in to Improve FooGallery, it can report only that Media Audit was successfully used recently, not the report contents.

Turning off the Media Audit feature under FooGallery > Features cancels any running audit and hides the screen, but preserves the latest saved report for a future reactivation. Deactivating FooGallery itself removes the Media Audit report and job data.