Use the Quick Links 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 the Quick links 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 might look different than what is described in the help articles. 

With Quick links, you can "pin" items to your page for easy access.

New Quick Links Screen

What would you like to do?

  1. If your page is not already in edit mode, select 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 or drag-and-drop Quick links from the list of web parts.

  3. Type over the Quick links title to add your own title.

  4. Select the layout options above the Quick links to select your layout. 

  5. Select Edit properties Icon for editing web part and section properties  to access additional options for the selected layout. Each layout has different options. For example, you can choose to Show image in layout for the Compact layout, and you can choose to Show descriptions for List and Button layouts.
    Properties pane showing additional options for a selected layout.

    Here's a comparison of how each of the layouts look:

Compact

Compact view of Quick Links

The compact layout is designed to show icons at 48 x 48 pixels.

Filmstrip

Comparison of Quick links compact and filmstrip

The Filmstrip layout is designed to show images at 212 to 286 pixels in width, with an aspect ratio of 9/16 where height is 9 and width is 16.

Grid

SharePoint only

Viewing quick links in the grid layout
        
        Button

SharePoint only

Button layout of quick links

List

SharePoint only

List layout

Tiles

SharePoint only

Quick links in a tile layout

  1. Select + Add links.

  2. Choose a recent file or get a file or image from one of the following locations:

    • Stock images provided by Microsoft

    • A site

    • Your OneDrive account

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

      A list of locations available when adding a link.

      Note

      • Web search uses Bing images that utilize the Creative Common license. You're 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.
  3. Select your image, page, or document and select Insert.

  4. In the toolbox on the right, you'll have options for each link. The options depend on the settings you've chosen for the layout. For example, if you chose to Show descriptions for a list layout, you can add a description for the individual link. Other types of options for individual links, depending on the layout options, include changing the image, formatting icons, adding descriptions, and adding alternative text.
    Options for an individual quick link

  1. If your page is not already in edit mode, select Edit at the top right of the page.

  2. Hover over the item you want to edit then select Edit Icon for editing web part and section properties  at the bottom of the item you want to edit.
    This will open the toolbox for that item where you'll have options for that link. The options depend on the settings you've chosen for the layout. For example, if you chose to Show descriptions for a list layout, you can add a description for the individual link. Other types of options for individual links, depending on the layout options, include changing the image, formatting icons, adding descriptions, and adding alternative text.
    Options for an individual quick link

  3. To remove links, select the Trashcan icon  Preview of the trashcan icon for web parts. for the item.

  4. To reorder links, drag and drop items to new positions using the Move icon  Preview of the move icon for web parts. . You can also reorder links using Ctrl + Left or Ctrl + Right arrow keys.

    Note

    You can't reorder links in the Filmstrip layout.

Audience targeting

By using audience targeting, you can promote links to specific groups of people. This is useful when you want to present information that's especially relevant to a particular group of people. For example, you can target links for specific project information to team members and stakeholders of the project. To use audience targeting, you must first enable audience targeting in the web part property pane, and then edit each quick link to specify the audience to target.

Note

If you've selected an audience group that you recently created or changed, it might take some time to see targeting applied for that group.

Enable audience targeting

  1. If your page is not already in edit mode, select Edit at the top right of the page, and select the Quick links web part.
  2. Select the Edit properties Icon for editing web part and section properties  button.
  3. In the Filter section, slide the toggle for Enable audience targeting to On.

Image of the edit pane with the toggle to enable audience targeting in the on position

Set the target audiences for each link

  1. If your page is not already in edit mode, select Edit at the top right of the page, and select the Quick links web part.
  2. Hover over the link you want to edit then select Edit Icon for editing web part and section properties  at the bottom of the item you want to edit.
  3. Under Audiences to target, type or search for the group(s) you want to target.

Image of the edit pane with the text box in which to set target audiences

On the page, while you're in edit mode, you can see which links have audiences selected by looking for the audience icon Image of the edit pane with the text box in which to set target audiences next to the link.

Once your page is published, audience targeting will take effect.