Advanced Media Library Filters - Documentation

1. Introduction

This plugin extends the native WordPress Media Library with advanced filtering capabilities for efficient asset management (List and Grid/Modal views).

2. Available Filters

3. Configuration & Synchronization

  1. Go to Settings > Media Filters.
  2. Filter Management: Enable or disable optional filters. Format and Size filters are native and always active.
  3. Metadata Synchronization:
    Important: If you install this plugin on a site with many pre-existing media files, you must run the Metadata Synchronization tool. New files are indexed automatically, but legacy files require this step to be filtered by size and dimensions.
    Click Sync Missing Metadata to initiate the indexing process for pre-existing files.

4. Frequently Asked Questions (FAQ)

Q: Why are my older images not showing up when filtering by size or orientation?

A: Legacy images lack custom metadata keys. Go to Settings > Media Filters and click "Sync Media Data" to index pre-existing attachments.

Q: Does deleting unattached media break my layouts?

A: "Unattached" indicates the item hasn't been set as a post parent. However, if you manually typed the image URL into a custom theme section or hardcoded it, deleting it will break that link. Review item names before purging.

Q: Why doesn't the native WP media type dropdown appear anymore?

A: The plugin intentionally hides the native dropdown to eliminate duplicate selectors and keep your interface uncluttered, replacing it with the advanced format extensions selector.

5. Support

Ensure you are running the latest WordPress version and verify there are no conflicts with other media management plugins.