Use the Image web part

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 how to use the Image web part. Use it to insert an image on the page, either from your site, your computer, or from the web.

Add an image to your page

  1. If you're not in edit mode already, click Edit at the top right of the page.

  2. Hover your mouse above or below an existing web part or under the title region, click Circled plus sign used to add a modern web part to a page , and then select the Image web part.

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


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

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

  4. Click Open or Add image (depending on where your image is coming from).

  5. Optionally, type a caption under the image in the web part.

  6. Click Edit web part Web part edit button (on the left) to change the image, add a link to the image, add text over the image, and to add or change alternative text (for people who use screen readers).

    Image web part toolbox

    Automatic alternative text When you insert an image, alternative text (for people with screen readers) is automatically generated. In many cases, the text is automatically saved with your image, unless you change or remove it. In cases where the confidence level of the alternative text for the image is not high, you'll see an alert on the image that allows you to review and change or keep the alternative text.

    Image with alternative text prompt

Crop your image

You can crop an image without or without using pre-set aspect ratios.

  1. If you're not in edit mode already, click Edit at the top right of the page.

  2. Click the image you want to change. The toolbar for editing images will be displayed.

    Image toolbar

    1. Aspect ratios

    2. Crop with free ratio

    3. Undo

    4. Reset

    5. Preview (save)

Crop using aspect ratio

Cropping with aspect ratio allows you to decide the proportion of the width and height of your image. The area outlined in blue in the following image shows a 1:1 (square) aspect ratio selection.

Aspect ratio crop example
  1. Click the Aspect ratios button Aspect ratio crop button .

    An additional toolbar will fly out, with options for different aspect ratios.

    Aspect ratio tools

    Select the aspect ratio you want. 16:9 is the left-most aspect ratio option, followed by 3:2, 4:3, and 1:1. You'll see a preview box to show you how your picture will be cropped. You can move the crop box within your picture to change area that is cropped.

    You can also rotate the crop box so to change how the aspect ratio orientation is displayed by clicking the Rotate crop box button Rotate crop box button .

  2. When you're done, click Save Save .

Crop manually

Free crop example
  1. Click the Crop with free ratio button Crop without aspect ratio button to crop without using aspect ratio. Then drag one of the squares on each side of the image to make your image narrower, wider, taller, or shorter.

  2. When you're done, click Save Save .

Resize an image

While you're in edit mode, you can resize an image by selecting it to show the resize handles, or by selecting the Resize button on the image toolbar. Then drag one of the handles to make the image the size you want.

Resize handles on image

Undo or reset

Use the Undo button Undo crop to undo the last action. Use the Reset button Reset image crop to undo all of the changes you've made at once, returning the image to the state it was in since you last saved.

Tip: For more information about images and aspect ratios, see Image sizing and scaling in SharePoint modern pages.

See Also

Image Gallery web part

Hero web part

Expand your Office skills
Explore training
Get new features first
Join Office Insiders

Was this information helpful?

Thank you for your feedback!

Thank you for your feedback! It sounds like it might be helpful to connect you to one of our Office support agents.