# Media gallery
_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**.* |


### 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.* |
_lQPVsb5w.jpg)
_sVUYfKGE.jpg)
_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

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

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**.