Media Policies

Property	Value
description	Current media settings and defaults shipped by MAC Core.
tags	doc, mac-core, setting, media
rating

Human: 4 - AI-assisted (low impact)

Some AI used for minor parts (phrasing, ideas), but nothing critical. Fully reviewed.

Overview

The media settings module controls image sizes, uploads, and compression behavior.

Current Settings

Setting key	Default	Behavior
custom_image_sizes_enabled	false	Registers custom proportional image sizes and exposes them in the media selector.
custom_image_widths	480, 768, 960, 1440	Width list used for the generated mac_image_{width} sizes.
remove_image_sizes_enabled	false	Removes configured image sizes from generation and selectors.
removed_image_sizes	See list below	Removes built-in, WooCommerce, Bricks, and advanced core sizes from generation and selectors.
allow_font_uploads	false	Allows common font MIME types in the media library.
block_video_uploads	false	Blocks common video MIME types from upload.
disable_image_compression	false	Forces max quality for JPEG, WebP, and AVIF uploads.

Default Custom Widths

The default custom image widths are:

• 480
• 768
• 960
• 1440

When enabled, the plugin registers these sizes as:

• mac_image_480
• mac_image_768
• mac_image_960
• mac_image_1440

They use a proportional height and do not hard crop.

Default Removed Sizes

The default removed-size list is:

• thumbnail
• medium
• medium_large
• large
• woocommerce_thumbnail
• woocommerce_single
• woocommerce_gallery_thumbnail
• bricks_large_16x9
• bricks_large
• bricks_large_square
• bricks_medium
• bricks_medium_square
• 1536x1536
• 2048x2048

Behavior Notes

Custom Image Sizes

When custom image sizes are enabled:

• the plugin enables post-thumbnails
• image sizes are registered during theme setup
• the custom sizes are added to the Media Library size selector

Removed Image Sizes

When removed image sizes are enabled:

• the list is applied to intermediate_image_sizes
• the list is applied to intermediate_image_sizes_advanced
• removed sizes are also taken out of image_size_names_choose
• the two advanced core sizes are explicitly unregistered so future uploads do not recreate them

Upload List Input

The list-based media settings accept either:

• one value per line
• comma-separated values

Saved values are normalized and deduplicated on write.

Regeneration Caveat

Changing image-size registration or removal rules does not regenerate existing uploads automatically. After changing production image-size definitions on an existing site, run a thumbnail regeneration tool intentionally.