Cosmero docsPre-release

Image gallery

2 min read

Image gallery shows a grid of up to 12 images, such as photos of your products in use. An image can link to a product, and then shows the product’s name on a tag over the image. A button beside the heading can link to your Instagram profile. The section shows only the images you add: it doesn’t load an Instagram feed.

Online Store → Themes → Customize

  1. In your Shopify admin, go to Online Store → Themes and select Customize on Cosmero.
  2. At the top of the theme editor, open the template you want to change, such as the home page.
  3. In the sidebar, select Add section.
  4. Choose Image gallery. It starts with six images.
  5. Add your images, then select Save.

You can add it to any template, but not to the header or the footer.

  • Heading: the section’s heading.
  • Text: a short text under the heading.
  • Button label: the text on a button beside the heading. The button shows when it has a label and a link.
  • Button link: where the button goes. When it’s empty, the button uses the Instagram link from Theme settings → Social media. The section doesn’t load an Instagram feed.
  • Columns on desktop: from 2 to 6 (default 6). Tablets show up to three, and mobile shows two.
  • Image ratio: Portrait (3:4, the default) or Square. Images are cropped to fill it.
  • Product tag color scheme: the colors of the product name tag on images linked to a product.
  • Color scheme: the colors of the panel. You edit color schemes in Theme settings.
  • Panel style: Panel is a rounded panel inside the page margin. Flush spans the full page width with square corners.
  • Enable full width on mobile: on mobile, the panel runs from edge to edge with square corners. Shown when Panel style is Panel.
  • Top padding: space above the content, from 0 to 120 px.
  • Bottom padding: space below the content, from 0 to 120 px. On mobile, both paddings are scaled down: 64 px becomes 40 px.

One image in the grid. The section holds up to 12.

  • Image: the image. Portrait images (3:4) work best. A placeholder shows until you choose one.
  • Product: links the image to the product and shows its name. On a computer, the name tag appears when the pointer is over the image or it has keyboard focus. On touch screens it always shows.
  • Link: where the image links. Used when no product is set.
  • Link description: describes the link for screen readers when the image has no alt text.
  • Add alt text to your images (in Content → Files in your Shopify admin). An image with a link uses it as the link’s name, so Link description is only needed for images without alt text.
  • With six images and Columns on desktop at 6, the gallery fills one row on desktop and three rows of two on mobile.

Still stuck? We answer.

Contact support