Custom content for Azure Dashboards

Custom content for Azure Dashboards

Not really significant, but still wanted to share how to extend your Azure Portal Dashboard with custom content. This is a very helpful feature, which is somewhat unknown to many, for placing side notes and instructions.

Custom content how to

I’ve found that for smaller Azure based projects, documentation and noted tend to get lost a lot easier. Which once was the holy grail eventually ends up as “Oh, this document somewhere in SharePoint.” Therefore, having a place for keeping custom content such as notes or linking to existing documents can be very helpful.

Now, instead of talking, let’s actually create some custom content for our dashboard.

It’s all about markdown

Within the Azure Portal, open your dashboard or create a new one. Enter edit mode by pressing on edit dashboard located within the upper section of the window.

Azure Portal - New dashboard

Within the Tiles Gallery locate Markdown and drag it to the dashboard canvas.

Azure Portal - Add Markdown component

Once places, you should see a 6 by 4 tiles large container with some sample content. In addition, the Edit Markdown blade will be opened on the right. If this is not the case, click on the Edit button located within the container.

Azure Porta l- The Edit Markdown blade

The container has 3 options for text entry; A title, Sub title and the most interesting part, called content. The content section supports Markdown, a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format.

You might already be familiar with markdown, but if not I would recommend checking the markup options available. You can find more details on the syntax on


I Hope this was helpful for some of you. I’m using the custom context tile quite a lot, especially when sharing dashboards. There isn’t a lot of space available for annotations when creating shared dashboards. And using markdown give me the opportunity to explain why and how a dashboard should be used.

Post Navigation