How to Customize Power BI Subscription Emails
Your Monday report email has arrived, but your manager still asks which figures she should review before the meeting.
PBRS lets you send the report with a clear, formatted message, so she knows what to open and what to prepare before you all sit down together.
Help her see why this email matters
Imagine your operations manager working through her inbox before the weekly meeting. There is a Power BI email among the replies and reminders. She recognises the report, but nothing in the message explains whether she needs to read it now or simply keep it for reference.
A few minutes later, she asks you which section the team will be discussing. You reply that it is the backlog and service-level figures. The report arrived on time; the explanation that would have helped her use it arrived separately.
That is a good reason to customise the email. A subject such as “Weekly operations — review before Monday’s meeting” gives it a place in her day. A short message asking her to review those two sections helps her prepare without another conversation.
PBRS lets you keep that message with the job that prepares and emails the report. You can format the body, include an approved link or company image, and maintain the attachment and sending account alongside it. Next week’s email can carry the same useful guidance without you composing it again.
Start with her question
Ask the manager what she needs to know when the email arrives. Her answer will give you a more useful opening line than a general announcement that a report is available.
Choose how much the email needs to change
If your manager only needs a clearer subject and a few lines of explanation, try the native Power BI subscription first. Its More options controls let you add a subject and message, choose the report-page preview and include a report link. That may be all this Monday email needs.
Suppose the reporting team also wants a consistent company heading, a link to the meeting notes and a PDF with a familiar filename. PBRS brings the accompanying message and file delivery into the same scheduled job. You can maintain the email without asking someone to forward the report with an explanation each week.
Before adding a logo, decide where you want it to appear. A logo inside the Power BI preview belongs in the report design. A logo above your instructions belongs in the email body. Changing one does not change the other, and a native subscription message is not a general HTML-template editor.
Reference: message, preview, attachment and sender controls
| What you want to change | Power BI subscription | PBRS Email destination |
|---|---|---|
| Subject and instructions | Edit the subject and message. | Compose an HTML or plain-text body and subject. |
| Branding around the message | The report design controls branding inside its preview. | Add images, links and formatting to the accompanying body. |
| The report itself | Choose a preview and eligible attachment options. | Configure the exported file separately, or embed supported report output. |
| Sending account | Check the sender used by your subscription. | Select an authorised account configured for PBRS. |
For native report subscriptions, the message appears above the preview; for dashboards, it appears below it. Sensitivity labels on native attachments do not protect the email text or preview image, so consider what information belongs in those areas.
Microsoft is changing how subscription messages are sent. Check the sender on a received test email before changing mailbox rules. See Microsoft’s subscription troubleshooting guide for the current requirements.
In PBRS, entering a different From address does not give the sending account permission to use it. Choose an account or SMTP server that your mail administrator has approved.
Keep the first version simple
A recognisable subject and a useful instruction may solve the problem on their own. Add a heading, image or link when it helps your manager find or understand something she needs.
Prepare the email she will read on Monday
Start with the Operations Summary and a test mailbox. Before working on colours or images, write the message you would send your manager yourself:
Your weekly Operations Summary is attached. Please review the backlog and service-level sections before Monday’s meeting, and bring any questions you would like the team to discuss. You’ll find the reporting period at the top of the report.
Those words fit our example because they explain what has arrived, why it matters and what to do next. Adapt them to your own meeting and report. If the email contains a link rather than an attachment, say that instead.
If the native subscription is enough
Open the subscription, expand More options and enter the subject and message. Choose the preview page that will help the manager recognise the report, and include the report link if she needs to explore the figures. Save the subscription and use a controlled Run now test. That sends the subscription; it does not refresh the model.
If you are preparing the message in PBRS
Open the schedule’s Email destination and select the approved sending account. Address the first copy to your test mailbox, then add the subject and accompanying message. Choose HTML if you want formatting, or Text for a plain message.
Use the body editor to add your company heading and any useful links. Then configure the attachment’s format and filename separately. For our Monday email, the words “is attached” should lead to the Operations Summary file the manager expects to open. The PBRS Email destination guide explains the available controls.
Read the received copy together
Run the job to the test mailbox and open the message on the devices your manager uses. Can she recognise the subject on her phone, read the instructions without loading images and open the right attachment? Follow any report link using her intended access, too.
Once she is happy with the first copy, set the approved recipients and recurring delivery. Keep the subject useful next week: a fixed date will grow stale. Use a stable subject, or a supported PBRS constant whose resulting value you have checked in a test email.
Make replies useful too
Agree who should receive questions about the report. Tell the manager how to reach that person, so a question about Monday’s figures reaches someone who can help.
Give the reporting team a reusable email body
If you help the reporting team with its email design, give them a small template they can understand and maintain. For the Monday Operations Summary, the useful parts are the report name, the request to review two sections and a clear indication of where to find the reporting period.
The example below is the accompanying HTML message for a PBRS Email destination. It does not change the Power BI report, and it is not code to paste into the native subscription message field.
HTML example: a readable body for the Monday operations email
Use this as a starting point for the accompanying message. Its simple table and inline styles keep the instructions together. Test the finished email in your actual mail clients before reusing it.
<table role="presentation" style="width:100%;max-width:600px;border-collapse:collapse">
<tr><td style="padding:16px;font-family:Arial,sans-serif;color:#143447">
<p style="font-weight:bold">Operations reporting</p>
<p>The Operations Summary is ready for review.</p>
<p>Please check the backlog and service-level sections before the meeting.</p>
<p>The reporting period is shown in the report.</p>
</td></tr>
</table>
Add only approved report links and branding images. Give a meaningful image alternative text, and keep the report name and meeting instruction as real text so they remain readable when images are blocked.
If you need a changing date or report value, insert it through the documented PBRS controls and inspect the result. The sample has no invented substitution tokens. Keep the attachment settings separate from the body, and check that the message still describes what the job actually sends.
When the team changes the template, send another test copy on desktop and mobile. Confirm the subject, sender, links and attachment as well as the appearance; a neatly formatted email is only helpful if it leads the manager to the right report.
Optional reference: embedded reports and mail transport compatibility
| Source or transport | Embedding support |
|---|---|
| Power BI Service reports, dashboards and Service paginated reports | Image |
| SSRS and on-premises paginated reports | Text, HTML, Image and Web Archive |
| HTML report embedding | Requires SMTP |
| MAPI | Text embedding only |
PBRS attaches exported output by default. The accompanying body format, embedded report format and attached-file format are separate choices; changing the body to HTML does not change the report’s supported embedding formats.
Leave something easy to maintain
Keep a copy of the approved message with the reporting job’s notes. A colleague should be able to update the meeting instruction without having to work out how the whole template was built.
Let her arrive ready for the conversation
Next Monday, your manager spots the Operations Summary in her inbox. The subject tells her it is for the meeting, and the message points her to the backlog and service-level sections. She opens the report and makes her notes. Your first conversation can be about the figures, rather than where to look.
Try that improvement with one recurring email. Keep the native subscription if a clearer subject and message meet the need. When you want the formatted message, sending account and prepared file maintained together, use the same report to evaluate PBRS. The Power BI Report Automation page shows how that email fits into a wider reporting routine.
Contributors:
Christian Ofori-Boateng
CEO, ChristianSteven Software
