
Use SharePoint Promoted Links to Display Project KPIs
If you are managing projects from a vanilla SharePoint site, you may wish to make your KPIs easily accessible on your project site. You could use SharePoint Promoted Links to display Project KPIs with some simple steps.
For this example, I am going to add a RAG on my project homepage on a SharePoint Online site. This solution will work on a SharePoint 2013 or 2016 On-Premises solution too – all using SharePoint Promoted Links!
Use SharePoint Promoted Links to Display Project KPIs
1. Upload Images
I have created some images to use for the SharePoint Promoted Links that you can download from here. If you go with your images, I would recommend the same naming convention for the process outlined in this blog to work.
I also suggest uploading the images if possible to a central location e.g. the top of the site collection, so you don’t have to repeat the upload on a site per site basis. However, if you don’t have access, that’s no problem!
For the site where you wish to add the images:
- Browse to Site Contents
- Create a new document library
- Name the library “KPI Image Repository”.
- Upload the images to the “KPI Image Repository” library. You can use drag and drop to make it faster.
- Tip: Note the path of the image repository up as far a Forms/ e.g. https://samplesite.sharepoint.com/sites/sandbox/KPI%20Image%20Repository/
- Tip: All images must be in the same file format e.g. PNG, JPEG.
2. Add the SharePoint Promoted Links app to your project site
You’ll need to add the promoted link app to the site first.
- Browse to Site Contents
- Click on “New” and then on “App”.
- Search for “Promoted Links”.
- Click on the image.
- Enter the name for the list e.g. “Project KPI’s.”
- A Promoted Links app by the name “Project KPI’s” is now available on your project site.
3. Add New Columns to the “Project KPIs” Promoted Links list:
You will need to add several columns to the list to let the underlying formula to work. It is possible to do some of this in SharePoint Designer for those of you comfortable using it.
Create a SharePoint column
- To create a column, click on “List” and “Create Column”.
Columns to Create
Name | Image Location |
Type | Single Line of text |
Default Value | [SiteNameWhereImagesAreStored] |
e.g. https://samplesite.sharepoint.com/sites/sandbox/KPI%20Image%20Repository/ | |
![]() | |
. | |
Name | File Format |
Type | SingleLineOfText |
Default Value | [FileTypeofImages] |
e.g. .png | |
![]() | |
. | |
Name | Trend |
Type | Choice |
Choice Categories | Up |
Down | |
Across | |
![]() | |
. | |
Name | RAG |
Type | Choice |
Choice Categories | Red |
Amber | |
Green | |
|
4. Delete and Recreate “Background Image Location” Column
In SharePoint Promoted Links there is an internal column called “Background Image Location”. We need to delete this and recreate as a calculated column type, concatenating the columns we recreated earlier on.
Delete a Column
- Click on “List”/”List Settings” on “Project KPI” SharePoint Promoted Links list.
- Click on “Background Image Location” under the “Columns” section.
- In the address bar of the browser, go to the end of the URL and note the internal field. It should be BackgroundImageLocation
- Click on “Delete” to remove the column
- Back on the List Settings page, click on “Create Column”
- Create the column as outlined below. Note there are no spaces in the Column name and it must be named exactly BackgroungImageLocation
Name | BackgroundImageLocation |
Type | Calculated Column |
Formula | =CONCATENTATE([Site Name],[RAG],[Trend],[File Format]) |
Calculated Column Type | Single Line of Text |
What this does, is create a URL to the location of the images that were uploaded
5. Add the “Project KPIs” Sharepoint Promoted Links web app to a page
For this example, I added to the homepage of the project site as I like to keep my KPIs front and center of my project page.
- Browse to the project home page
- Click on “Page” in the ribbon
- Select “Edit Page”
- Select the area that you would like to add the “Project KPIs” Sharepoint Promoted Links and click on “Add a Web Part”
- From the Apps Category, click on “Project KPIs” then Add.
- Back on the ribbon at the top of the page, click on “Stop Editing”.
- The KPIs should now be on the home page.
6. “Update KPIs” Quick Launch link
Now that you have it the “Project KPI’s” Sharepoint Promoted Links appearing on the dashboard, you may want to make it easy for project managers to update.
- Browse to the site contents
- Click on the “Project KPIs” Sharepoint Promoted Links app
- Click on “List” / “Create View”
- Click on “All Promoted Links” under Start from an existing view
- Call the view “Update Project KPIs”
- Only make visible the RAG and Trend columns. Click OK.
- Copy the URL of the page view e.g. https://samplesite.sharepoint.com/sites/sandbox/CiaraTestTeamSite/Lists/Project%20KPIs/Update%20Project%20KPIs.aspx
- Go to Site Settings
- Create a new link, e.g. Update KPIs on the Quick Launch using the URL that was just copied. How this is done differs from the SharePoint versions.
- When the user changes the KPIs from there, it will update the images on the Promoted Links!