> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wisepim.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Media Library Settings
> Set how your media library looks, how files are handled on upload, and let WISEPIM auto-link images to the right products.
Media Library settings control how your asset library looks by default, how WISEPIM handles files when you upload them, and whether images get linked to the right products automatically. Get these right once and every team member starts from the same clean, consistent view.
Pick a project in the project switcher before you open Media Library settings. These settings are **project-level**, so they apply to the selected project only.
## Display preferences
These settings decide how the media library looks the first time it loads. They give your whole team a consistent starting point for browsing assets.
### Default view mode
Choose how assets appear:
| Option | What you get |
| -------- | ---------------------------------------------------------------------------- |
| **Grid** | A visual grid of thumbnails, ideal for scanning images at a glance (default) |
| **List** | A detailed table view, better when file names and metadata matter most |
### Default grid zoom
When **Grid** is selected, set the thumbnail size, from **Extra Small** (maximum density) to **Extra Large** (best for detail). Smaller zoom levels fit more assets on screen; larger ones make individual images easier to inspect. This option is disabled in List view.
### Default sort
Pick the field the library sorts by on first load, plus the direction:
* **Sort by**: Date Added, Date Modified, File Name, File Size, File Type, or Rating.
* **Direction**: **Descending** (newest, largest, or Z–A first) or **Ascending** (oldest, smallest, or A–Z first).
Sort by **Date Added, Descending** so your team always sees the freshest uploads first. Switch to **File Name, Ascending** when you need a predictable, alphabetical browse.
### Asset card details
Two toggles control how much metadata each asset card shows:
* **Show file sizes**: displays the file size (for example, 1.2 MB) on each card. Useful for spotting oversized images before they slow down your storefront.
* **Show image dimensions**: displays the pixel dimensions for images. Handy for confirming an asset meets a channel's resolution requirements at a glance.
## Upload behavior
These settings control what happens automatically the moment a file enters your library, so your team spends less time on cleanup.
* **Detect duplicate files**: warns you when a file with the same name or content already exists, so you avoid cluttering the library with copies.
* **Auto-generate thumbnails**: creates optimized thumbnails for uploaded images automatically, keeping the grid view fast and crisp without any manual work.
Leave both on. Duplicate detection keeps your library clean, and automatic thumbnails keep the grid view fast even with thousands of assets.
## Auto-link images to products
This is where the media library saves the most time. When auto-linking is on, every image you upload is matched to a product automatically, based on an identifier embedded in its filename. No more opening products one by one to attach photos.
Turn it on with **Enable auto-linking**. When it is off, your auto-link configuration is saved but no automatic linking happens.
### How matching works
WISEPIM reads the filename, pulls out the identifier, and finds the product whose identifier matches. You control three things: which identifier to match on, how it is separated in the filename, and how strict the match is.
**Identifier field** — the product field to match against. Choose from:
| Field | Matches against |
| --------------------- | -------------------------------------------------------- |
| **SKU** | Product SKU codes |
| **EAN** | European Article Numbers |
| **UPC** | Universal Product Codes |
| **MPN** | Manufacturer Part Numbers |
| **Product Name** | Product names |
| **Custom attributes** | Any text or identifier attribute defined on your project |
**Filename separator** — the character that splits the identifier from the rest of the filename. Pick **Underscore** (`SKU123_front.jpg`), **Hyphen** (`SKU123-front.jpg`), **Dot** (`SKU123.front.jpg`), **Space** (`SKU123 front.jpg`), or **Exact match**, where the entire filename (before the extension) must equal the identifier.
**Strip file extension** — when on, the extension (for example, `.jpg`) is removed before matching, so `SKU123_front.jpg` becomes `SKU123_front`.
**Case-sensitive matching** — when on, uppercase and lowercase must match exactly (`SKU-1` will not match `sku-1`). Leave it off for forgiving, case-insensitive matching, which is usually what you want.
### Walkthrough
With **SKU** as the identifier, **Underscore** as the separator, **Strip file extension** on, and case-insensitive matching, uploading `SKU-12345_front.jpg` runs like this:
`SKU-12345_front.jpg` becomes `SKU-12345_front`.
Split on the underscore and take the first part to get the identifier `SKU-12345`.
Look for a product whose SKU equals `sku-12345`, ignoring case.
Attach the uploaded image to the matched product automatically.
The settings panel shows a live preview of this flow as you change each option, so you can confirm your filename convention works before you upload a batch.
Name your image files with the product identifier up front, for example `EAN8710400000123_main.jpg`. A consistent naming convention from your photographer or supplier means an entire upload links itself in one pass.
If the identifier in a filename does not match any product, the image is still uploaded to your library — it just stays unlinked. Check your separator and case-sensitivity settings against a real filename before running a large import.
## Save your changes
Edit any setting on this page and a save bar appears at the bottom:
* **Save**: stores your media settings on the project.
* **Undo**: reverts every change back to the last saved state.
## Related
Upload, organize, and attach assets to products in the library itself.
Set the default columns, sorting, and filters for the product table.
Create the custom identifier attributes you can match filenames against.
Browse every personal and project setting in one place.