# Media grid

<figure><img src="https://3146423938-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZQuVfmt0J7tzTvfBqG6C%2Fuploads%2FRsIkmajwVYg8HWShw5NS%2FPrimavera%20Distinction%202025-04-02%20at%203.43.15%20pm.jpg?alt=media&#x26;token=01b6c1f2-0ada-48b4-a088-3480109e4f8e" alt=""><figcaption><p>Media grid on Savoir demo store</p></figcaption></figure>

{% hint style="success" %}
**Quick start**

* Click into each **image** block to upload/select an image
* If you want to keep the **rich text** block, edit the nested **heading** and **button** blocks
  {% endhint %}

### Settings

* **Desktop columns**
* **Mobile columns**
* **Layout**: If the number of images exceeds the number of columns, choose to display them either as a grid or as a slideshow
* **Container type**: See [common settings](https://docs.ultramarinastudios.com/common-settings)
* **Vertical grid gap**: Keep as default or override to create tight grids
* **Horizontal grid gap**: Keep as default or override to create tight grids
* **Slideshow** settings apply to the slideshow layout:
  * **Arrow position**: Choose between overlay (arrows appear over the blog posts) or below
  * **Counter style:** Choose between hidden, counter or progress bar
  * **Button style:** Choose a button style for when the arrow position is set to overlay (arrows will have a simple text style if they're positioned below)

### Blocks

This section comes with four types of blocks:

* [Section header](https://docs.ultramarinastudios.com/sections/section-header) (hidden by default, fill in the settings to display)
* **Rich text**: Allows you to add a simple rich text block like the Savoir example above ("Get Inspired")
* **Image** (similar to the [image theme block](https://docs.ultramarinastudios.com/blocks/image)):&#x20;
  * **Image**
  * **Image ratio**
  * **Behavior:**
    * **Link**: Optionally link the image to another page or social media post
    * **Link label**: If you've added a link, describe the link destination for accessibility
    * **Product**: Optionally, connect a product to display the quick add button
* [Buttons](https://docs.ultramarinastudios.com/blocks/buttons) (hidden by default, fill in the settings to display)

{% hint style="info" %}
Can't find the setting you're looking for?  The following settings are explained in detail in [common settings](https://docs.ultramarinastudios.com/common-settings):

* Container type
* Color scheme/Color scheme transition
* Padding
* Borders
  {% endhint %}

### Examples & inspiration

<div><figure><img src="https://3146423938-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZQuVfmt0J7tzTvfBqG6C%2Fuploads%2FSimLckLQXiecAPzAGy8U%2Fmedia-grid-composition.webp?alt=media&#x26;token=11d266ad-7db5-4d80-b276-33160d1368f9" alt=""><figcaption><p>Composition media grid, featuring square images with no spacing.</p></figcaption></figure> <figure><img src="https://3146423938-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZQuVfmt0J7tzTvfBqG6C%2Fuploads%2FhkuSOl59EIc3jqOPx4kN%2Fmedia-grid-gloss.webp?alt=media&#x26;token=27ac74b9-7958-4d08-a1bd-a2b62439171a" alt=""><figcaption><p>Gloss media grid, featuring portrait images with no spacing</p></figcaption></figure> <figure><img src="https://3146423938-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZQuVfmt0J7tzTvfBqG6C%2Fuploads%2FD5k0eAgRCDkrJKbFYGy2%2Fmedia-grid-gaia.webp?alt=media&#x26;token=ed630a4e-0832-460b-8e69-8d85eb99dd56" alt=""><figcaption><p>Gaia media grid, featuring square images with no spacing</p></figcaption></figure> <figure><img src="https://3146423938-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZQuVfmt0J7tzTvfBqG6C%2Fuploads%2FtjuepizCUL6GEd7mlpok%2Fmedia-grid-primavera.webp?alt=media&#x26;token=43fdac96-5975-4bc7-a9d5-fd1ccd8ff121" alt=""><figcaption><p>Primavera media grid, featuring images with narrow spacing</p></figcaption></figure> <figure><img src="https://3146423938-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZQuVfmt0J7tzTvfBqG6C%2Fuploads%2FbJ14R960GPlirCDEMwJf%2Fmedia-grid-savoir.webp?alt=media&#x26;token=0d60d654-3d9d-4989-9123-75ad3b64b863" alt=""><figcaption><p>Savoir media grid, with a page width container and narrow spacing</p></figcaption></figure></div>
