Skip to content

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

  1. Click the Add Profile button add-profile
  2. Enter a Name for the profile (e.g., "product-thumbnail")
  3. Optionally enter a Hint to describe its purpose
  4. Set the Width and Height dimensions for the processed image
  5. Select the Resize Mode (Default (Max), Max, Crop, Pad, BoxPad, Min, or Stretch)
  6. Choose the Format (PNG, JPG, or WebP)
  7. Set the Quality level (0-100)
  8. Check Auto Orient if needed to correct image orientation
  9. Click Save to create the profile create media 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:

  1. Original file is preserved
  2. System creates optimized versions based on active profiles
  3. Each profile creates a processed copy with its specific settings
  4. The appropriate profile version is used in different parts of the system

When you edit a profile, images are automatically reprocessed on next use.