853
Free
Add to project

Product support

Get help in the plugin support forum.

Categories

Image Tailor

Automatically resize and convert Tailor-uploaded images to WebP in OctoberCMS.

Image Tailor is a focused utility plugin for OctoberCMS projects built with Tailor. It optimizes images at the moment they are uploaded through Tailor fileupload fields configured with mode: image.

Instead of keeping oversized original uploads, the plugin resizes images to fit configurable dimensions, preserves the original aspect ratio, prevents upscaling, and replaces the uploaded file with a lightweight WebP version. The result is faster pages, smaller media files, and a cleaner editorial workflow without extra manual work.

Why Image Tailor?

Tailor makes structured content easy, but image uploads often remain too large for production websites. Image Tailor solves that automatically.

  • Automatically optimizes images on upload
  • Converts images to WebP for significantly smaller file sizes
  • Preserves proportions and never crops
  • Never upscales smaller images
  • Replaces the original file instead of storing duplicates
  • Supports per-field size overrides in Tailor blueprints
  • Can be enabled or disabled globally from backend settings
  • Fails safely and never interrupts the upload process

Features

  • Processes image uploads in Tailor fileupload fields with mode: image
  • Resizes images to fit within configurable maximum width and height
  • Preserves aspect ratio and never crops
  • Converts images to WebP for smaller file sizes
  • Never upscales images
  • Replaces the original file instead of storing duplicates
  • Supports per-field overrides via imageWidth and imageHeight
  • Can be enabled or disabled globally from backend settings
  • Safe fallback behavior if image processing fails

Documentation

For installation instructions, configuration details, and full documentation, see:

Installation via Command Line

php artisan plugin:install DMdev.Imagetailor

Image Tailor Documentation

Image Tailor automatically resizes uploaded images and converts them to WebP in OctoberCMS Tailor fileupload fields.

It is designed for projects where editors upload images through Tailor and the site needs lightweight, web-ready files without manual optimization.

Repository

Source code, updates, and issue tracking:

Features

  • Processes image uploads in Tailor fileupload fields with mode: image
  • Resizes images to fit within configurable maximum width and height
  • Preserves aspect ratio and never crops
  • Converts images to WebP for smaller file sizes
  • Never upscales images
  • Replaces the original file instead of storing duplicates
  • Supports per-field overrides via imageWidth and imageHeight in blueprint configuration
  • Can be enabled or disabled globally from backend settings
  • Fails safely, so uploads are never interrupted if image processing fails

Requirements

  • OctoberCMS 4.x
  • PHP 8.1+
  • GD extension with WebP support
  • Composer 2.x

Installation

Install via Composer

composer require dmdev/imagetailor-plugin
php artisan october:migrate

Manual installation

  1. Copy the plugin to plugins/dmdev/imagetailor
  2. Run the migration command:
php artisan october:migrate

Backend Settings

Go to:

Settings → CMS → Image Tailor

Setting Default Description
Enabled Yes Turns image processing on or off globally
Max Width 1200 px Default maximum width when a blueprint does not define imageWidth
Max Height 1200 px Default maximum height when a blueprint does not define imageHeight

Tailor Blueprint Example

images:
    label: Images
    type: fileupload
    mode: image
    imageWidth: 800
    imageHeight: 800

How It Works

  1. A new System\Models\File record is created during upload
  2. The plugin checks whether the uploaded file is an image
  3. If the image is already WebP and within configured limits, it is skipped
  4. Otherwise, the image is resized and converted to WebP
  5. The original file record is updated directly instead of creating a duplicate file

Per-field Overrides

Global image size limits can be set in backend settings, but specific Tailor fields can override them with:

  • imageWidth
  • imageHeight

This is useful when different content types need different image dimensions.

Limitations

  • Only processes files on first upload
  • Requires GD with WebP support
  • WebP conversion is irreversible after the original file is replaced
  • Non-image files are passed through unchanged
1.0.2

Align plugin code and author code with Marketplace author code DMdev.

Apr 22, 2026
1.0.1

Use SettingModel base class, add category to settings, improve temp file cleanup.

Apr 22, 2026
1.0.0

Initial release. Auto-resize and WebP conversion for uploaded images in Tailor entries.

Apr 22, 2026