Organizing and Managing Promoted Links (Tiles)

Promoted Links list in SharePoint are very popular, and I see a lot of customers creating them in many places in their sites, giving each page a nice, modern appearance with pretty clickable tiles.  In this post, I’ll show you a way I’ve devised to keep them organized and managed in one list for a site, so that they can easily be displayed on multiple pages on the site, without the need for creating multiple promoted links lists for different purposes.  The idea is that we will create one Promoted Links list called “Tiles”, and create an extra column (multi-select choice) called Show On, where we can set the values of the pages that we want each tile to be displayed on.  This can be done in Office 365, SharePoint 2013, and SharePoint 2016.

  1. Create a Promoted Links list on your site, called Tiles. (Click Add an App, and choose Promoted Links, then name it “Tiles”)
  2. Decide what your pretty tile icons will be.  I usually just upload them all to the already existing “Site Assets” library.  I usually use Metro Studio to create mine.  As you create each tile, this is how you will get the URL for each icon, to use it as the background image for each tile.
  3. Go to your new Tiles list.  In the Items tab in the ribbon, click the List tab in the ribbon, and click the Create Column button.  Name it Show On, make it a Choice column, and choose Checkboxes (allow multiple selections).  Type the names of the different pages on your site where you may want to display these tiles.  In this case, it’s an HR site, and there are pages such as Home, Training, and Benefits.
  4. Still in your Tiles list, go to the Items tab in the ribbon, and click to create a new item.  Add all of your tiles, and for Show On, check the boxes next to the page or pages that you’d like each tile to appear on.
  5. In your Tiles list, from the List tab, go to the All Promoted Links view.  Modify it so that you include the new Show On column.  I usually also like to add the Edit column, so it’s quicker to get in there and edit existing items.
  6. Create at least one filtered view for these tiles, filtered on Show On. This part is important, because without a filtered view already created, some future steps won’t work.  When you click Create View, you have to select Standard View.  For Sort By, select Order.  In this example, I’m creating a filtered view for all of the items that will show on the home page, so my view is called Home, and Show On will equal Home.  For the filter, Show On is equal to Home.  Don’t worry that it’s multiple selection, even if you have other items selected besides home, the filter will work correctly.
  7. The last step is to place this Tiles list as a web part on each of your pages, such as Home, Training, and Benefits.  If you haven’t created the pages besides Home yet, use the gear at the top right, and Add a Page to create each one.  When you click to add/insert a web part on your page, choose Tiles.
  8. The web part will show all tiles by default.  Go to the web part properties toolpane, and you’ll notice that there is no button to Edit Current View, like you usually see in a list web part.  This is why we created the filtered view at step 6.  In the Selected View drop-down, choose the name of the filtered view you created. Mine is called Home.  Click OK to the warning, and click OK at the bottom of the web part toolpane.


From now on, when you need to add or edit the tiles that show on pages, all you have to do is go to the Tiles list, and the All Promoted Links view, and edit them from there, and you won’t have to edit all of those individual pages, and you won’t need a bunch of separate tiles lists.

Notice that the next time you go into the web part properties, the Edit the current view option DOES show there now.  So, now you have the ability to go in and change the view settings or filter if need be.  Go to each of your other pages, and follow steps 7 and 8 again.  Here is a pretty screenshot of an example of a promoted links list:


A few side notes:

  • You may be wondering why I didn’t create the Show On field as a lookup to the Pages or Site Pages library, instead of having to keep up with a choice field with the page names.  There are a couple of reasons for this.  First of all, the name of the page doesn’t show as a field you can pick from when creating the lookup.  Second of all, with a lookup it won’t allow you to have multiple select.
  • You may be wondering about the Order field.  You can use numbers of course, to order the items, just keep in mind that they will show in that order on each page, sorted by the order field.  So a caveat is that it may not work out if you want some certain icon to show first on one page, and last on another page, because the order depends on what other tiles are showing there and its relation to them in the numbering scheme.
  • Do you get frustrated when site users want to create tiles for every single list and library on your site? It seems redundant, right? I agree, but IF you want to hand pick your own pretty icons to represent each of those lists, this seems to be the only way.  Alternately, if you’d like to use a more efficient way, this blog post by Kameron Berget shows a great way to use the content search web part, and have the results show appearing as a list of promoted links!


  • Excellent Blog. Great time saver. Thank you

  • This is great. Thanks for posting.

    Ideally though I want to use these steps above but then add a choice filter on a page to display the relevant Promoted Links according to the options entered in “Show On”

    But I can’t seem to associate a Choice Filter Web Part to the Promoted Links list (Tiles view). Is there a way to do this?

    • Hi Frosty, that’s a great idea, I see what you mean. I’ve successfully connected a current user filter web part to the promoted links, but sorry, I’ve never tried the choice filter. Maybe that needs to entail JavaScript instead, I’m not sure.

  • Thanks for sharing this post!

  • Is there any way to do this for sub sites?

  • Hi,

    This is a fab article and has helped significantly with organising my tiles. There’s one further step that I’d like to implement, but I’ve not managed to find an answer. I’d like to colour the background automatically, based on a column attribute.

    I’ve found lots of scripting methods of colouring the tiles, but not based on an attribute. Any help / thoughts on this would be great.


    • That does sound like a job for JavaScript, but I don’t know how it would be done, and have never come across any examples. Great idea, though.

    • I believe if you choose a .png icon instead of a .jpg icon, the background is sheer and displays the corresponding color of your site.

  • Hi Laura,
    I get how to get the URL using the classic library view, but I’m struggling with the new library experience view. Is there an easy way to get the image URL from the new experience or are we eagerly awaiting for MS to add this feature back? It is causing my end users a lot of grief as they have no knowledge of URL structures so adding the image name to a path is not a skill they would have.

  • Hi Laura! Do you know if is it possible to get -through SP 2013 out-of-the-box features- the same FILTER and SORT behaviors as shown on the link below?

  • Can I have multiple links in 1 tile?

  • I followed the instructions and was able to get the filtered down Promoted Links to show — but it’s showing in list view. I can’t figure out how to switch it back to tile view without it bringing back in ALL my links instead of just the links set up in the view.

  • Hi Laura – This is great and really helped as I was guilty of creating different tile lists for each area. My question pertains to the structure of the tiles view. Once you get past several in a list (like 8 or 9), you have to scroll to the right to see them all as they stay in one row. Is there a way to have them show up in multiple rows instead of just one?

    • You have to put extra code on the page, as embed code or in a content editor web part.

      /* Tile Row Height */
      .ms-promlink-body {

      /* Tile Row header */
      .ms-promlink-header {

      /*Removes header, arrows & white space at top*/

      /* Title dimension, including inter-tile margin */
      .ms-tileview-tile-root {
      height:105px !important;
      width:105px !important;

      /* Title and Description text */
      .ms-tileview-tile-content, .ms-tileview-tile-detailsBox, .ms-tileview-tile-content > a > div > span {
      height:100px !important;
      width:100px !important;

      /* Image size in tile */
      .ms-tileview-tile-content > a > div > img {
      width:100% !important;

      /* Title background image dimensions */
      .ms-tileview-tile-content img {width: 100px; height: 100px;}

      /* Title and Description Text */ {

      /* Description medium text class */ {

      /* Description MediumExpanded, LargeCollapsed, LargeExpanded text class */
      .ms-tileview-tile-titleTextMediumExpanded, .ms-tileview-tile-titleTextLargeCollapsed, .ms-tileview-tile-titleTextLargeExpanded {

      /* Title text when description not shown */
      .ms-tileview-tile-titleTextMediumCollapsed {
      background:none repeat scroll 0 0 rgba(0,46,79,0.7);

      /* Description Medium text class */ {

  • I added this code to a Content Editor webpart on the page and it just displays the code. Am I missing a step?

  • I can get up until the list is fully created with tiles but when I go to add the webpart to my home page and select List (preview) (its the only options that is shown that says list) and it gives me some lists I have never seen before… what am I doing wrong? Its like my tile list isnt being shown in the webpart list options.

  • Hello, Can I have your help please. I have created my Promoted List link and I have added it to my home page (but it is only on the left hand side). I was wanting to see the actual tiles on the home page, if that makes sense?

    Sorry for being vague, I am very new to this.

  • Jeannette Phillips

    So, does this work when you have OOB SP?

  • Jeannette Phillips

    After I upload the web part – promoted links, then select edit web part, then Selected View – all I see is the filtered tiles in the list view on the site page/webpart… can’t get the icons to show.

  • Hi,

    Is it possible for me to add more than one link in a tile, by that i mean for example i need to have a benefit tile and in that tile it has multiple link or document. is that possible to do?

  • It only shows as a list and not the Promoted Links when added to a page. Is there something I am doing wrong. I have tried to put it into a web part, and in content editor.

    • Sounds like it is displaying the list view, did you change the default? You do not need to use Content Editor web part to do this.

      Add the promoted links web part to your page, then edit web part and change view to ‘Tiles’.

  • Still relevant, still helpful! Thanks for this!

Leave a Reply