# Media gallery ![image](https://docs-assets.foxecom.app/pebble-theme/Fox-BG%20Light%20\(31\)_W9asWSiL.jpg) Show a set of images and videos in a grid or carousel, each with a short heading and an optional link, to showcase your products, categories, or brand visuals. ## How to customize the Media gallery section 1. Open the page where you want to display the section in the theme editor by clicking **Edit theme**. 2. Click **Add section**. 3. Select **Media gallery**. 4. Click a **Gallery item** block. To add another item, click **Add block** under the section and select **Gallery item**. 5. Select **Image** or **Video** in **Type**. 6. Click **Select** to add the image or video. 7. Enter the item title in **Heading**. 8. Repeat steps 4–7 for each item. 9. Click the **Header** block to edit the heading content. 10. Click **Save**. ## Section settings ### Layout Controls how gallery items are arranged on desktop and larger screens. | Setting | Description | Options | | ------------------ | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | **Container** | Controls the width of the section content. | **Full:** Uses the available page width.

**Fixed:** Keeps the content within the theme's fixed container width. | | **Type** | Determines how gallery items are displayed. | **Grid** or **Carousel**. | | **Columns** | Sets the number of items displayed per row on larger screens. | **2–8 columns**. | | **Horizontal gap** | Controls the horizontal spacing between items. | **0–100px**. | | **Vertical gap** | Controls the vertical space between rows of items. | **0–100px**.

*Available when **Type** is set to **Grid**.* |
![image](https://docs-assets.foxecom.app/pebble-theme/image_dmhZSWLq.png) ![image](https://docs-assets.foxecom.app/pebble-theme/image_Cd0nfuWD.png) ### Mobile layout Controls how the section appears on mobile devices. | Setting | Description | Options | | -------------------------- | -------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------ | | **Enable swipe on mobile** | Controls whether customers can swipe horizontally through items on mobile. | **On** or **Off**. | | **Custom column width** | Lets you manually control the width of each item on mobile. | **On** or **Off**.

*Available when **Enable swipe on mobile** is turned on.* | | **Custom width** | Sets the width of each item on mobile. | **20–90%**.

*Available when **Custom column width** is turned on.* | | **Mobile columns** | Sets the number of items displayed per row on mobile. | **1 column** or **2 columns**.

*Available when **Custom column width** is turned off.* | | **Horizontal gap** | Controls the horizontal space between items on mobile. | **0–100px**. | | **Vertical gap** | Controls the vertical space between rows of items on mobile. | **0–100px**.

*Available when **Enable swipe on mobile** is turned off.* |
![image](https://docs-assets.foxecom.app/pebble-theme/Fox-BG%20Light%20\(32\)_lQPVsb5w.jpg) ![image](https://docs-assets.foxecom.app/pebble-theme/Fox-BG%20Light%20\(33\)_sVUYfKGE.jpg) ![image](https://docs-assets.foxecom.app/pebble-theme/Fox-BG%20Light%20\(34\)_jLrsmgwe.jpg) ### Appearance Controls the visual style of the section. | Setting | Description | Options | | ------------------ | ----------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------- | | **Color scheme** | Applies a theme color scheme to the section. Learn more in [Colors](https://docs.foxecom.com/pebble-theme/theme-settings/colors). | Select an available color scheme. | | **Border** | Controls whether the section has an outline. | **None** or **Solid**. | | **Border width** | Controls the thickness of the section border. | **0–10px**.

*Available when **Border** is set to **Solid**.* | | **Border opacity** | Controls the opacity of the section border. | **0–100%**.

*Available when **Border** is set to **Solid**.* | | **Corner radius** | Controls how rounded the section corners appear. | **0–32px**. |
### Padding Controls the top and bottom spacing separately for desktop and mobile. | Setting | Description | Options | | ----------- | ------------------------------------------------------------- | :------------------------- | | **Devices** | Selects which device-specific padding values you are editing. | **Desktop** or **Mobile**. | | **Top** | Controls the space above the section content. | **0–100px**. | | **Bottom** | Controls the space below the section content. | **0–100px**. |
### Advanced | Setting | Description | Options | | ------------------ | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | **Custom columns** | Sets the number of columns for each screen size, separated by commas. | Enter values such as `mb:1,md:2,lg:3,xl:4,xxl:5`.

*Leave blank to use the theme's default column settings.* |
Learn how to write the values in [Custom columns](https://docs.foxecom.com/pebble-theme/global-settings/custom-columns). ## Blocks The section includes one **Header** block and multiple **Gallery item** blocks. ### Header ![image](https://docs-assets.foxecom.app/pebble-theme/image_l2mN0iP6.png) The **Header** block holds the heading content above the gallery. | Setting | Description | Options | | ------------- | ------------------------------------------------------------- | ------------------------------- | | **Alignment** | Sets the alignment of the header content. | **Left, Center,** or **Right**. | | **Devices** | Selects which device-specific padding values you are editing. | **Desktop** or **Mobile**. | | **Bottom** | Controls the space below the header. | **0–100px**. |
The default **Header** includes **Heading** and **Text** blocks. To add more, click **Add block** inside the **Header** and select one of these blocks: * [**Heading**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays the main title of the section. * [**Subheading**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays a short line above or below the heading. * [**Text**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays additional descriptions or details. * [**Image**](https://docs.foxecom.com/pebble-theme/theme-blocks/image): Displays an image or icon. * [**Button**](https://docs.foxecom.com/pebble-theme/theme-blocks/button): Displays a call-to-action button. ### Gallery item ![image](https://docs-assets.foxecom.app/pebble-theme/image_MYBIeLGY.png) Each **Gallery item** block adds one image or video to the gallery. #### Gallery item - Media | Setting | Description | Options | | --------------- | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | **Type** | Sets the type of media shown in the item. | **Image** or **Video**. | | **Image** | Sets the image of the item. | Select or upload an image, or click **Explore free images**.

*Available when **Type** is set to **Image**.* | | **Video** | Sets the video of the item. | Select or upload a video.

*Available when **Type** is set to **Video**.* | | **Cover image** | Sets the image shown before the video starts. | Select or upload an image, or click **Explore free images**.

*Available when **Type** is set to **Video**.* |
Gallery item images don't have a ratio setting and always display as squares (1:1). Upload square images for the best result. #### Gallery item - Content | Setting | Description | Options | | ----------- | ------------------------------------------------- | ------------------------ | | **Link** | Sets where customers go when they click the item. | Paste a link or search. | | **Heading** | Sets the title shown with the item. | Enter your text. | | **Preset** | Sets the typography style of the heading. | Choose a preset style | | **Color** | Sets the color of the heading. | **Text** or **Subtext**. |
#### Gallery item - Appearance | Setting | Description | Options | | ----------------- | --------------------------------------------- | ----------- | | **Corner radius** | Controls how rounded the item corners appear. | **0–32px**. |
To remove an item, open its **Gallery item** block and click **Remove block**.