When you add a modern page to a site, you add and customize web parts, which are the building blocks of your page. This article describes the Image gallery web part.

Note: Some functionality is introduced gradually to organizations that have opted in to the Targeted Release program. This means that you may not yet see this feature or it may look different than what is described in the help articles.

Use the Image gallery web part to share collections of pictures on a page. Select your images with the file picker or drag them onto the web part.

Add the Image gallery web part

  1. If you're not in edit mode already, click Edit at the top right of the page. Find the Toolbox (Toolbox icon in content pane) on the right.

  2. Select See all web parts, then select Image gallery from the list of web parts.

  3. Click Add a title to enter a title for your Image gallery.

  4. Click Edit properties (Icon for editing web part and section properties) to specify the layout.

    With the Tiles layout, you can choose an aspect ratio (1:1,16:9, or 4:3), and you can drag and drop images within the web part to reorder them.

    Image Gallery Web Part Tile View

    With the Carousel layout, users can cycle through images by pressing the arrows on either side. You cannot reorder images in this layout.

    Image Gallery Web Part Gallery View  

    Note: If you have opted in to the Targeted Release program , and you have Content Network Delivery (CDN) enabled on your library, you can also set whether to automatically cycle through images, and the speed at which to cycle. This feature will be generally available later.

  5. With SharePoint in Microsoft 365 or SharePoint Server Subscription Edition using the Bricks layout, you can show several images of various sizes, automatically "layered" in a pattern like that of a brick wall.

    Image Gallery Bricks layout

Select individual images

  1. Drag images onto the web part, or click + Add.

  2. Choose a recent image or an image from one of the following:

    • Stock images provided by Microsoft

    • A web search

    • A site

    • Your computer

    • A link

    • If your organization has specified a set of approved images, you'll be able to choose from that set under Your organization.

      Image of file picker options.

      Notes: 

      • Web search uses Bing images that utilize the Creative Common license. You are responsible for reviewing licensing for an image before you insert it on your page.

      • Stock images is only available on SharePoint Online.

      • If you're a SharePoint Admin and want to learn how to create an asset library for Your organization, see Create an organization assets library.

      • If you're a SharePoint admin, we recommend enabling a Content Delivery Network (CDN) to improve performance for getting images. Learn more about CDNs.

  3. Click Open to add the images you've selected.

  4. For each image, you can include a title, description, and alternative text by clicking the edit button (Icon for editing web part and section properties) on each image.

  5. To add more images, either drag and drop the images onto the page or click + Add to select additional images.

Tip: To learn more about how images are sized in different layouts, see Image sizing and scaling in SharePoint modern pages.

Need more help?

Want more options?

Explore subscription benefits, browse training courses, learn how to secure your device, and more.

Communities help you ask and answer questions, give feedback, and hear from experts with rich knowledge.