SharePoint Online: How to Add Promoted Links to Modern Page?

Requirement: Add promoted links to the modern SharePoint Online page.

When building intranet portals or team sites, we may have to link to frequently used sites, documents, etc., from the home page. We’ve used something called “Promoted links” in classic SharePoint sites to achieve this. Promoted Links in SharePoint is used to quickly share links with images. Basically, you create a Promoted Links List, Add links-assign images to the links and organize them, and then it automatically creates a Tile view for you! Remember the promoted links web part placed on every SharePoint site’s home page with the “get started with your site” title and icons?

sharepoint online promoted links tile

Well, In modern SharePoint Online, the promoted links are no longer supported. As an alternative solution, we can use the Quick Links web part to get promoted tiles with similar functionality and look & feel. In this post, we will show you how to add promoted links to a modern page in SharePoint Online.

Promoted links are clickable tiles that can be used to navigate to other pages or resources within SharePoint or to external websites. They can be a great way to provide quick access to important information or resources, and they can be customized to match the branding of your organization.

Here is how to create promoted links in modern SharePoint Online pages:

  1. Navigate to your modern SharePoint Online page, and click on “Edit” from the top-right corner. Mouse over the section you want to insert promoted links web part >> Click on the + icon to add a new web part to the page, search and pick “Quick Links”, and then add it to the page.
  2. Click on the “Add links” button in the Quick Links web part to insert links you want to appear as tiles. Specify the details for the link to be created. This could be any existing document/site/page, including non-SharePoint and external sites. Populate all links as per your requirement. Choose the “Icon” or custom image for your link tiles.
  3. Set the layout options for quick links to “Tiles” and set the Icon size property to medium or large.
    creating promoted links in sharepoint online
  4. Now, your Quick link should look like this:
creating promoted links in sharepoint online

Creating promoted links in SharePoint On-premises and SharePoint Online classic experience is explained in another article: How to Create promoted links in SharePoint?

Salaudeen Rajack

Salaudeen Rajack - Information Technology Expert with Two-decades of hands-on experience, specializing in SharePoint, PowerShell, Microsoft 365, and related products. He has held various positions including SharePoint Architect, Administrator, Developer and consultant, has helped many organizations to implement and optimize SharePoint solutions. Known for his deep technical expertise, He's passionate about sharing the knowledge and insights to help others, through the real-world articles!

3 thoughts on “SharePoint Online: How to Add Promoted Links to Modern Page?

  • In SharePoint 2013 there is an app you can add called Promoted Links. Like the person says below, that is what you see on the top of the page. It is managed with a list and you can make/assign your own icons. If you search the web you can also find code to resize or wrap these into different shapes.

  • This is not using promoted links. The value of promoted links is that they are stored in a list and can be used and reused through out the site, with filtering based on the needs of that particular page, as well as audience targeting. The Quick Links web part is NOT that, at all. Quick Links are like reinventing the wheel each time you need the web part.


Leave a Reply

Your email address will not be published. Required fields are marked *