Create and use modern pages on a SharePoint site

Using pages is a great way to share ideas using images, Excel, Word and PowerPoint documents, video, and more. You can create and publish pages quickly and easily, and they look great on any device.

When you create a page, you can add and customize web parts, and then publish your page with just a click.


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

  • You must be a site owner or SharePoint administrator to add pages. If you are a site owner but you are unable to add a page, your administrator may have turned off the ability to do so. 

  • This article applies to modern pages in SharePoint Online or SharePoint Server 2019. If you are using classic pages, or you are using an earlier version of SharePoint, see Create and edit classic SharePoint pages.

  • Creation of modern pages is supported in the Site Pages library only. Additionally, you cannot change the URL of a page.

Your browser does not support video.

What would you like to do?

Add and publish a page

  1. Go to the site where you want to add a page. 

  2. Go to the home page of the site.

  3. Select + New, and then select Page.

    New Page

    Alternately, you can go to an existing page, select + New, and select Start from a blank page. Or, you can choose Copy of this page to create a new page that has the same web parts and content as the existing page.

  4. Choose a page template to start with.

    Template gallery
  5. Add a page name in the title area. A page name is required to save the page. See the Customize the title area.

  6. Add web parts

    Hover your mouse below the title area and you'll see a line with a circled +, like this:

  7. Plus sign for adding web parts to a page

    Click + to add content like text, documents, video and more. To learn more about how to find and use web parts, see Using web parts.

    Add to page button

    You can also add sections and columns to a page. To learn more, see Add sections or columns on a page.

  8. When you're done editing, you can click Save as draft to save your changes and close edit mode. Your audience won't see the page until you publish it. Only people with edit permissions on your site will be able to see it.

  9. When you are ready for your audience to see the page, click Publish.

    For more information on publishing and the lifecycle of a page, see Management and lifecycle of a SharePoint modern page.

Customize the title area

You can customize the title area with an image, a choice of four layouts, text above the title, the ability to change the displayed author, and you can show or hide the published date.

  • Add an image

    To add an image, click Add image Add image button in the toolbar on the left.

    Choose a recent image or get an image from stock images provided by Microsoft, from a web search, your site, your computer, or 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.

    • Images look best when they are landscape or 16:9 or greater in aspect ratio, and when they are at least 1 MB in size. For more information on image sizing, see Image sizing and scaling in SharePoint modern pages.

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

  • Additionally, you can set a focal point to get the most important part of your picture in the frame. Click Set focal point Set focal point button in the toolbar on the left, and within the image, drag the focal point where you want it.

    Focal point

  • Add, or change displayed page author

    In the title area, add a name, partial name, or email name in the author box. The name will be searched against your organization's profiles, and you will be presented with suggested people. Choose the one you want, and you're done! If you do not enter a name, an author byline will not show.

    Page author entry box

  • Choose a layout

    Click the Edit web part button Web part edit button, and in the toolbox on the right, choose the layout you want:

    Options for page layouts

  • Set alignment

    If the toolbox isn't already showing, click the Edit web part button Web part edit button, and in the toolbox on the right, choose Left or Center.

  • Add text above the title

    You can add text in a colored block above your title to qualify the title or call attention to something on the page, as in the example below where NEW is the text above the title. In newspaper jargon, this is called a kicker. The color of the block the text is in is based on your site theme.

    Text above title

    To add the text above your title, click the Edit web part button Web part edit button, and in the toolbox on the right, enter up to 40 characters of text in the Text above title box. Then, change the Show text block above title toggle to Yes.

  • Show published date

    To show the latest published date of the page in the title area, slide the toggle under this option to Yes.

To modify the title area later, just make sure your page is in edit mode, select the title area, and then use the toolbar on the left to change title text and other information, and use the image button to change the image. To change the name in the title area, just select the title area and type over the existing name.

Help others find your page

The first time you publish your page, you'll be prompted to help others find your page. If you want to do this later, you can click Promote at the top of the page after the page is published.

Options to help others find your page.

You can use one or more of the following options:

  • Add page to navigation: Adds a link to your page, using the page title, to the left-side navigation.

  • Post as News on this site: Adds a News post to the Home page of your site. For more information on News, see Keep your team updated with News on your team site.

  • Email: Allows you to send an email with a preview of the page and an optional message to your selected recipients.

  • Copy address: The page address is shown so you can copy it and send to others.

Edit your page

To make changes to your page, do this:

  1. Click Edit at the top right.

    When you click Edit, the page is checked out to you. As long as the page is open for editing, or checked out, no one else can edit it. The page is "locked" until changes are saved or discarded, or until the page is published. An exception is that if the page has no activity for 5 minutes, the editing session will time out and the page will be "unlocked."

  2. Make your changes. For help on page layout and using web parts, see Add sections and columns on a page and Using web parts on SharePoint pages.

  3. When you're done making changes, choose Save as draft to save your changes and close edit mode.

  4. If you're ready for users to see your changes, click Republish. For more information on publishing and the lifecycle of a page, see Management and lifecycle of a SharePoint modern page.

While making changes to your site, such as adding or modifying web parts, you can undo or redo the changes. Select Undo, and from the dropdown, select Undo or Redo as needed. (You can also use the keyboard shortcuts of Ctrl+Z or Ctrl+Y, respectively.)

Undo/Redo dropdown displayed when in Edit mode for a SharePoint site


  • Specific permissions are required to edit and rename pages. If you can't rename a page, contact your site administrator to make sure you have Delete Items permission. If you can't edit a page, make sure you have Browse User Information permission.

  • If you are used to working with customized pages and site definitions, you should know that this type of page has no association with a site definition; therefore, it cannot be reset to a site definition.

Use page anchors (bookmarks)

Page anchors (also known as bookmarks) are automatically added to Heading 1 styles in Text web parts on your page.  When a page is published, and you hover over a Heading 1 in a Text web part, you'll see a link symbol indicating the page anchor.

Example of page anchor link

You can right-click a page anchor and select "copy link" from your web browser's context menu to copy the page anchor location for use outside of SharePoint pages. Once the page anchor is on the clipboard, it can be pasted into emails, instant messages, or other such items. 

When you add a hyperlink to your page, you can jump to a Heading 1 in any text web part by appending the pound symbol (#) and the heading 1 text you want to jump to at the end of the link, as in this example:

Example of a link with bookmark

Comments, likes, and views

People who view your page can leave comments and likes at the bottom of the page. You can also see how many views your page has. Hover over Likes to see some of the people who liked your page. Click on Likes and you can see a list of all of the people who liked your page.

alternate text

When someone likes or comments on a page or a news post you created, or mentions you using @, you will be notified by email.

Note: Comments, likes, and views are not available on site home pages.

Use Immersive reader in pages

Use the immersive reader tool to help your audience focus on the content of your site. The immersive reader tool includes built in text to speech, and word-in-line highlighting. Immersive reader can be used to suit the individual needs of each site user making the site easier to engage with.

Site users can change the speed and voice of the reader, as well as various visual aspects of the text itself. Immersive reader also offers the ability to translate the content on the page to a wide variety of languages.

Screenshot of the immersive reader task bar

To use immersive reader:

  1. Select the Immersive reader option in the task bar.

  2. When the immersive reader page appears, adjust the Text preferences  screenshot of text preferences icon , Grammar Options  screenshot of grammar options icon, and Reading Preferences screenshot of reading preferences icon  .

  3. After you have chosen your immersive reader experience preferences, select Play at the bottom of the screen.

Note: The immersive reader feature is not available on the home page.

Expand content (focus mode)

Eliminate visual distractions by using expand mode in SharePoint Site Pages. Expand mode helps you focus on the primary content by removing navigation bars on the page.

Screenshot of the expand content task bar

Activate Expand content by selecting the Expand content icon screenshot of expand content icon   in the task par of the site page.

Expand mode can be deactivated by selecting the Collapse content icon  screenshot of collapse content icon  while in the Expand content view.

Save for later

People who view your page can find it more easily later by using the Save for later option at the bottom of the page. Once Save for later is clicked, it becomes Saved for later, and the associated icon is filled in.

Save for later command on a page

Note: Save for later is not supported for Guest users. They may be able to select Save for later, but the item won't be saved.

When Saved for later is clicked, a list of Recently saved items is displayed. You can click See all saved items to see the entire list of saved items.

Recently saved items

Send your page by email

When you use this feature, you can send an email that includes a link, thumbnail preview, description and an optional message to one or more people.

Send by email dialog box

Note: The people you share the link with must have the appropriate permissions to be able to see your page.

  1. At the top of your page, click Send by email.

  2. Enter the name(s) of the people you want to send to in the To: box, and add a message if you want.

  3. Click Send.

Where are pages stored?

Pages that you create, save, or publish are stored in the Pages library for your site. To get to the Pages library:

  1. Go to the site where your page is.

  2. On the top or left side navigation, select Pages.

    If you don't see Pages on the left side, select Site Contents from Settings  on the upper right, then on the left side of the Site Contents page, select Pages.

    Your page may be in a folder within the Pages library designated by the site owner.

Delete your page

SharePoint site owners and administrators can easily delete modern pages from a SharePoint site. For more information on how to delete a page, see Delete a page from a SharePoint site.

Using web parts

Web parts are the building blocks of your page. You'll see them when you click the + sign on the page to add content to your page. For more information on the different types of web parts and how to use them, see Using web parts on pages.

Need more help?

Expand your skills
Explore Training
Get new features first
Join Microsoft Insiders

Was this information helpful?

What affected your experience?

Thank you for your feedback!