Documentation version
TroubleshootingApplies to 1.0.0

Featured Image crop looks wrong on mobile

Fix background or Hero focal-point problems caused by narrower aspect ratios.

Backgrounds using cover must crop when the container aspect ratio differs from the source image.

Adjust position

Move the background position toward the subject or important visual area.

Review hero height

An unnecessarily tall mobile hero can force more aggressive cropping.

Choose better source images

For reusable templates, encourage Featured Images with enough visual space around the subject to survive multiple crops.

Use responsive controls

Where the control supports breakpoint-specific values, set mobile behavior deliberately instead of relying on the desktop value.