Configurable image fit for carousel items

Overview

Carousel images now support a configurable image fit option, giving you more control over how each image is displayed in the carousel. By default, images continue to use cover, but you can now choose contain at the carousel level or override the setting for individual images. This helps you make sure your images appear the way you intended, without important parts being cropped out of view.

What this solves

Previously, carousel images always used a fixed cover behavior. This made sure each section of the carousel was fully filled, but it often cropped out important parts of the image. The problem was most visible with images sourced from outside the platform or with images that had unusual proportions.

The result was a poor visual experience and limited control for app managers and home managers who wanted to preserve the full image within the tile. The new image fit setting solves this.

How it works

Image fit options

Image fit is the setting that controls how an image fills the section of the carousel it appears in. There are two options:

Default behavior

• Carousel images continue to use cover by default.

• In this mode, each image fills its section of the carousel and may be cropped to do so.

Set the default image fit for the whole carousel

A new default image fit setting is available in the carousel edit settings. From there you can pick the option you want applied to all supported items in the carousel.

1. Open the carousel and go to its edit settings.

2. Find the default image fit setting.

3. Choose cover or contain as the default for the carousel.

4. Save your changes.

Override the image fit for individual images

If a specific image in the carousel needs a different setting from the rest, you can override the default for just that image.

1. Open the carousel item that contains the image.

2. Locate the image fit control for that image.

3. Choose cover or contain to override the carousel default.

4. Save your changes.

This gives you more precise control when different images need to be displayed differently.

Who can use this feature

The image fit setting is available to users who can edit the carousel. This includes:

• App managers.

• Home managers.

Availability across content types

Supported items

The image fit option is available for the following carousel items:

• Pages.

• Events.

• Social campaigns.

• Video files in MP4 format.

• External links.

Not supported

The image fit option is not available for these items:

• Albums.

• Personalized carousel items.

Note: The image fit option only appears when an image is available for the item added to the carousel. If an item has no image, you will not see the control.

Troubleshooting

If something does not look right after changing the image fit setting, check the sections below for common issues and resolutions.

The image fit option does not appear on a carousel item

This usually happens for one of two reasons:

Changed the carousel default, but one image still looks the same

• Why this happens: Image-level overrides take priority over carousel defaults. If a specific image was previously overridden, changing the carousel default will not affect it.

• How to fix it: Open the affected carousel item, locate the image fit control for that image, and either:

  • Change it to match the new carousel default, or

  • Choose the option that best suits that specific image.

Image is being cropped after changing the setting

• Why this happens: This is expected behavior when using the cover setting. Cover fills the entire section, which may crop parts of the image when the image and section have different proportions.

• How to fix it: Switch the image fit to contain. Apply this at the carousel level so it applies to all supported items, or apply it only to the specific image where cropping is unwanted.

Empty space appears around the image after switching to contain

• Why this happens: This is expected behavior. Contain shows the full image without cropping, so if the image and section have different proportions, empty space will appear around the image.

• How to fix it: Choose one of these options:

  • Switch back to cover and accept that some cropping may occur.

  • Use an image with proportions that more closely match the carousel section.

The image fit setting is not visible at all

• Why this happens: The image fit setting is only available to users with edit access to the carousel, specifically app managers and home managers.

• How to fix it: Ask an app manager or home manager to make the change, or request edit access if it is needed for this carousel.

An override set on an individual image disappeared

• Why this happens: Image-level overrides are tied to the specific image in the carousel item. If the image was removed and re-added, or the carousel item was replaced, the override is lost along with the original image.

• How to fix it: Open the affected item, find the image fit control, and apply the override again.

Frequently asked questions

Q: What is the default behavior for new and existing carousels?

Ans: Cover is the default, which matches how carousel images have always behaved. Your existing carousels will continue to look the same unless you change the setting.

Q: Can I mix cover and contain in the same carousel?

Yes. Set the default at the carousel level, then override it on individual images that need a different treatment.

Q: Why don't I see the image fit control on a particular item?

Ans: The control only appears when the item has an image. Items without an image will not show the option. The option is also unavailable for albums and personalized carousel items.

Q: Will switching to contain leave empty space around my image?

Ans: It can. Contain shows the full image without cropping, so if the image and the section have different proportions, you may see space around the image. Choose the option that best suits each image.

Q: Who can change the image fit setting?

Ans: Anyone who can edit the carousel. This includes app managers and home managers.