Media Profiles¶
Configure image processing templates that automatically resize, format, and optimize images for different uses in the system.
Navigation:
Admin → Media → Profiles
Screen Overview¶
The Media Profiles screen allows you to create and manage image processing profiles. Each profile defines how images are processed when used in different parts of the system.
Key Features¶
Add Profile¶
- Click the Add Profile button to create a new media profile
- Configure settings for image sizing, format, and optimization
Search Profiles¶
- Use the search field to find existing profiles by name
Creating a Media Profile¶
- Click the Add Profile button

- Enter a Name for the profile (e.g., "product-thumbnail")
- Optionally enter a Hint to describe its purpose
- Set the Width and Height dimensions for the processed image
- Select the Resize Mode (Default (Max), Max, Crop, Pad, BoxPad, Min, or Stretch)
- Choose the Format (PNG, JPG, or WebP)
- Set the Quality level (0-100)
- Check Auto Orient if needed to correct image orientation
- Click Save to create the profile

Profile Settings¶
Basic Information¶
- Name - Unique identifier for the profile (e.g., "product-thumbnail", "receipt-logo")
- Hint - Optional description of what this profile is used for
Image Dimensions¶
- Width - Target width in pixels for processed images
- Height - Target height in pixels for processed images
Processing Options¶
- Resize Mode - How to handle size mismatches:
- Default (Max) - Resize to fit within dimensions, maintaining aspect ratio
- Max - Resize to maximum size within dimensions
- Crop - Crop to exact dimensions
- Pad - Resize with padding added around image
- BoxPad - Resize with box padding
- Min - Resize to minimum size within dimensions
-
Stretch - Resize to exact dimensions (may distort image)
-
Format - Output file format:
- PNG - Best for logos and graphics (supports transparency)
- JPG - Best for photos (smaller file size)
-
WebP - Modern format (best compression)
-
Quality - Compression level (0-100):
- 100 - No compression (highest quality, larger files)
- 90 - Good for most uses (balanced)
- 85 - Acceptable for thumbnails (smaller files)
Advanced Options¶
- Auto Orient - Automatically correct image orientation based on EXIF data
How Profiles Work¶
When you upload images to the Media Library:
- Original file is preserved
- System creates optimized versions based on active profiles
- Each profile creates a processed copy with its specific settings
- The appropriate profile version is used in different parts of the system
When you edit a profile, images are automatically reprocessed on next use.