Navigate to Media Library › Gallery from the top menu. The gallery opens with a left sidebar showing All Media with a live image count and a Folders section (click + to create your first folder). The toolbar provides a search bar, filter pills — All / Used / Unused / Products / Website / Blog / Messages / Attachments — plus icons for advanced filters, import, rebuild, and Upload. On first open, the module automatically imports all existing Odoo image attachments and builds the full usage index.

Switch to Media Library › Images in the top menu to open the standard Odoo kanban view. Each card displays a thumbnail, the file name, pixel dimensions (e.g. 500 × 500 px), and a green uses badge showing how many times the image is referenced across Odoo. This view is ideal for a quick visual scan of your entire library with usage counts at a glance.

Click the list-view icon in the top-right of Media Library › Images to switch to a tabular layout. Columns show Name, a thumbnail, Folder path (e.g. Contacts / vendors), Size (KB), Usages count, and an Unused toggle. The record counter (e.g. 1–38 / 38) confirms the total. Use this view to sort, group, filter, or bulk-select images for mass actions.

The gallery offers three layers of filtering you can combine freely:

• Search by name — type any part of the filename into the search bar to instantly narrow the grid to matching images.
• Filter pills — click Used, Unused, Products, Website, Blog, Messages, or Attachments to restrict results by usage location in one click.
• Advanced filter bar — click the funnel icon to expand filters for Size (KB) range (Min – Max), minimum pixel dimensions (W × H), Type (All types / JPEG / PNG / WebP / etc.), and an Uploaded date range.
• Tags — assign tags to images from the detail panel and filter the gallery by tag to group images independently of folders.

All four layers work together — for example, type a filename, select Unused, and set a minimum size to find large orphaned images with that name, ready for cleanup in one step.

Click + in the sidebar Folders header to create a root folder, or use the folder context menu to add a subfolder. The sidebar shows a live count next to each folder name (e.g. Customers 5, vendors 3). Click any folder to browse its images — the breadcrumb above the grid shows your current path (All Images › Contacts › Customers). When unused images are present, a red Delete all unused button appears in the toolbar for one-click cleanup.

Hover or right-click any folder in the sidebar to open its context menu. Available actions are: New subfolder — add a child folder; Move to folder — relocate the entire folder tree; Change color — set a custom icon color; Edit — rename the folder; Delete — remove it (only available when the folder is empty). Safeguards prevent moving a folder into itself or any of its own subfolders.

Click any image card in the gallery to open the detail panel on the right. The panel shows the image name, action icons (share link, download original, delete), and the full metadata: Dimensions (e.g. 275 × 183 px), File size, Type (e.g. image/jpeg), Folder (editable dropdown to move the image), and Uploaded date. The Used On count shows how many records reference this image — a count of 0 with "Not used anywhere" confirms the image is safe to delete.

A Choose from Media Library button is automatically injected next to every backend image field across Odoo — products, contacts, blog posts, email templates, and more. Open any record (e.g. Inventory › Products › Cabinet with Doors), locate the image field, and click the button to open the library picker without leaving the current form. No re-upload, no copy-paste.

The picker dialog opens over the current form and provides the full gallery experience: All Images count, folder sidebar, filter pills, search bar, and an Upload button. Browse or search for the image you need, click its card to select it (highlighted with a green border), and review the preview and metadata in the bottom bar. Click Select Image to apply it — the field is updated instantly and a source link is created so the usage index reflects the assignment immediately.

Open a page in the website editor and click any image to select it. The builder panel on the right shows image controls (Replace, Add More, Remove All). At the bottom of the viewport an image toolbar appears with Media, Replace, and Remove options. Click Replace or Media to open the media selection dialog where the library tab is available.

In the Select a media dialog, click the Media Library tab (next to Images). The full library picker loads with All Images count, folder sidebar (Contacts, Employee, Products, etc.), and an image grid showing all your library images with usage badges. Click an image to select it, then click Add to replace the current page image — the src attribute is updated instantly with no page reload.

The selected library image is applied to the product page immediately — no re-upload, no broken link. The page now displays the new image in full quality. Save the page to publish the change. The usage index updates on the next nightly cron run or on a manual rebuild, marking the image as Used on this website page.

The steps below cover the Settings page, file-type tab navigation, model-based filter pills with record search, and the tabbed usage breakdown in the detail panel — all added to give you precise control over what the library tracks and how you filter it.

Navigate to Media Library › Configuration to control exactly what the module tracks and displays. The Settings page is divided into three clear sections:

• Allowed File Types — toggle each category the gallery accepts. Images (JPEG, PNG, GIF, WebP, SVG) is enabled by default. Additional categories — Videos (MP4, WebM, OGG, MOV, AVI), PDFs, Spreadsheets (Excel, .xlsx, .csv, ODS), Documents (Word, .docx, ODT, TXT, RTF), Presentations (PowerPoint, .pptx, ODP), Archives (ZIP, RAR, 7z, TAR, GZ), and Audio (MP3, WAV, OGG, FLAC, AAC) — can be switched on as needed. The Attachments option catches any file type not covered by the specific categories above, and files appear in an Attachments section of the gallery.
• Filter Models — select which Odoo models appear as filter pills in the gallery toolbar. Tick a model to make it a one-click filter option for users. Available models include Blog Post, Companies, Contact, Employee, Journal Entry, Mass Mailing, Product, Project, Sales Order, Task, Transfer, Email Templates, Message, Page, and User. Only the models you tick appear in the toolbar — keep it focused on what your team actually uses.
• Upload Limits — set the maximum upload size (in MB) that applies to all file types. The default is 50 MB.

Once additional file types are enabled in Configuration, a row of file type tabs appears at the top of the gallery area — one tab per enabled category. Each tab shows the category name and a live count of files in that category (e.g. Images 31, Videos 2, PDFs 2, Spreadsheets 2, Presentations). Clicking a tab switches the entire gallery grid to show only files of that type.

The existing filter pills — All, Used, Unused, and any model pills enabled in Configuration (e.g. Products) — stay active within the selected tab. This means you can combine tabs with pills freely: for example, select the PDFs tab and click Unused to instantly isolate unreferenced PDF documents ready for cleanup.

Every model enabled in Configuration appears as a filter pill in the gallery toolbar (e.g. Products). Clicking a model pill restricts the gallery to media that is linked to records of that model — images assigned to products, contacts, blog posts, and so on. Each card still shows its Used badge and usage count.

When a model pill is active, a Search records… text field appears immediately to its right. Type any part of a record name to narrow the gallery down to a single record — for example, type a product name to see only the media assigned to that specific product. This gives you a precise audit of image assignments at the individual record level without leaving the gallery.

Click any image card to open the detail panel. The USED ON section now shows a tabbed breakdown of every record that references the image, grouped by model type:

• All — the total usage count across all models combined (e.g. All 2).
• Per-model tabs — one tab per model type that references the image (e.g. user_profile 1, Products 1), each showing how many records of that type reference it.
• Record list — clicking a tab reveals the specific record names grouped under their model heading (e.g. CONTACT — Abigail Peterson, PRODUCT — Acoustic Bloc Screens), each with an Open link to jump directly to that record in Odoo.

This breakdown answers "where exactly is this file used?" at a glance — no extra navigation required. The Open link beside each record name lets you jump straight to the product, contact, or page that uses the file, making cross-reference checks effortless.

Click the Videos, PDFs, Spreadsheets, or Presentations tab to switch the gallery to that file type. The grid adapts: instead of image thumbnails, each card displays a file-type icon (e.g. a PDF icon for documents), the file name, and the file size. Used and Unused badges remain on every card, and the sidebar folder tree, filter pills, and search bar all work exactly as they do for images.

This unified interface means you can manage all your media — product spec PDFs, training videos, spreadsheet templates — from one place. Upload a PDF, assign it to a folder, confirm it is referenced somewhere, and delete unused documents using the same workflow as your image library, without switching to a separate tool.