Events
Power BI DataViz World Championships
Feb 14, 4 PM - Mar 31, 4 PM
With 4 chances to enter, you could win a conference package and make it to the LIVE Grand Finale in Las Vegas
Learn moreThis browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Use custom help panes and guided tasks to give your Unified Interface application a custom in-product help experience that is tailored to your organization. Use custom help panes to provide table, form, and language-specific help and guidance that includes rich text, content links, images, and video links.
Important
The new guided help implementation of custom help panes differs from the previous learning path guided help feature. Both features let you create custom help for your application. However, custom help panes are optimized for the most common guided help scenarios.
Custom help panes provide the following key features that are not available with learning path:
Custom help panes don't provide the following key features that are available with learning path:
To use the custom help panes feature, your environment needs the following:
Open a model-driven app, and then on the command bar select Settings > Advanced Settings.
Go to Settings > System > Administration.
On the Administration page, select System Settings.
On the General tab, under Set custom Help URL, select Yes for Enable Custom Help Panes and Guided Tasks, and then select OK.
Important
More information: Security roles and privileges
Each help pane is unique for these contexts:
By default, a help pane stays open and on the help content you first opened it with even when you navigate to a different form. This allows for the help content to remain intact as you direct users to different parts of the app.
To view the help pane, open a model-driven app, and then on the command bar select Help.
On the Help pane, select the vertical ellipsis, and then select Edit.
The help pane is now in edit mode and the cursor is positioned on the help pane title.
From the edit pane you can perform the following tasks:
To save your changes, select Save.
Text can be placed anywhere within the help pane. Enter free-form text before, in, or after sections. Text supports bold, italic, underline, and strikeout font formats. Cut, copy, and paste can be used as well as multilevel undo.
Selecting the bullet or number icon toggles the current line to become bulleted or numbered. If you have selected multiple lines in a list, each line becomes bulleted or numbered. Tabbing and indenting subnumbers align within the list.
A section is a collapsible text box. You can put links or free-form text in it. Use a section to group similar items. A section can be either open or collapsed by default.
You can insert videos and static images into your help pane. Videos and images are links to content on the internet. Custom help panes do not store the video and image files in your help pane. When the help pane is opened, custom help panes bring the content in from the link to display it. You can use a link to a Microsoft Stream video if you want to reference corporate private content.
Tip
Remember to copy the link URL for the video or image you want so you can paste it into your help pane.
Custom help panes support the following video sources:
Links can be to websites and open in the same window (the default) or open in a separate window. The ability to link to an existing help page is not yet enabled.
Balloons and coach marks can be used to point to specific UI elements. A balloon can have text in it.
A coach mark simply highlights an element with a coach pointer to draw the user's attention to that UI element.
Author needs to define the target through drag and drop capability in the properties of balloons and coach marks. Author can input the text for title and description for coach marks.
Note
All help content is stored in a help page component in Dataverse as part of your solution. When you move your solution from one environment to another, such as from test to production, you can define that your help rows are exported so that they are included in the solution. This enables you to keep your help content in sync with features in your solution as it moves to different environments. As a part of your solution, custom help panes support all standard solution application lifecycle management (ALM) features.
By default, all new help pages appear in the default solution. If you want to move your content to another environment, first add your existing help pages into an unmanaged solution before you export them. To add a help page to an unmanaged solution, follow these steps:
You might want to back up or store your content in a source code control system. You might also like to use documentation automation tools, such as translation tools or checkers, on help pane content. The custom help pane data is stored directly in Dataverse and can be exported and imported for this purpose.
Custom help panes support a custom XML format. This format is documented below. More information: Custom help XML definition
When exported, each help page is exported as a separate file.
The custom help panes and guided tasks feature consists of the solution components in the Contextual Help managed solution. Customizing or creating records using the tables outside of the custom help panes and guided tasks feature isn’t supported.
Notice that some apps, such as Dynamics 365 Sales and Dynamics 365 Service, include first run experiences that are built by using tables included in the Contextual Help managed solution. For example, both the Help Page (msdyn_helppage) and Tour (msdyn_tour) tables are used in the creation of these first run experiences. Currently, the custom help panes and guided tasks feature doesn’t support creating these first run experiences.
This section discusses frequently asked questions about custom help pages.
Custom help panes and guided tasks are an option in the Set custom help URL section of system settings. Custom help panes and guided tasks enable a customizable help pane that shows up right next to the user’s form. The other options in this system settings set custom help section comprise the customizable help features. They allow you to override the default apps help and point users in your organization to a different URL for help. Alternatively, you can override the help for a highly customized table so that you can better describe your workflow.
For more information about customizable help, see Enable and use customizable help.
Learning path has two types of help: help panes and sequential help balloons. The sequential help balloon locations are deeply integrated with the legacy web client UI and are not transferrable to the new custom help panes.
Depending on how much text you have in your guided help it might be easiest to simply copy the information directly from the learning path user interface to the new custom help pane user interface. However, you can also export your learning path help content. The simplest way to do this is to export your content using the Learning Path > Content Library > Localize > Export feature. Select the rows you want and then export them. This creates an XLIFF file for each help pane and guided task. Then, use a publicly available XLIFF editor or XLIFF to HTML converter to retrieve your content.
This section describes the custom help XML definition.
<pphml>
<h1>FAQ</h1>
<collapsible title="What is PPHML?">
<p>PPHML is a domain specific language for help content. It is used to create help content that includes elements such as images, videos, balloons, coach marks, etc.</p>
</collapsible>
<collapsible title="What does PPHML stand for?">
<p>PPHML stands for Power Platform Help Markup Language</p>
</collapsible>
</pphml>
The <pphml>
element tells the help browser that this is a PPHML document.
The <pphml>
element represents the root of a PPHML document.
The <pphml>
element is the container for all other PPHML elements.
Presents a title in a help page.
<h1>This will be displayed at the top of the help page</h1>
The <h1>
element defines the title of a help page.
<h1>
This must be the first element inside <pphml>
.
Presents an image in a help page.
<img src="smiley.gif" alt="Smiley face" title="Smiley face"/>
The <img>
element embeds an image in a help page.
src
: Specifies the URL of an image. This attribute is required.
title
: Specifies a title to show along with the image, typically as a hover tooltip.
alt
: Specifies an alternate text for an image. This text is used by screen readers.
Presents a video in a help page.
<video src="https://www.youtube.com/watch?v=WSWmn7WM3i4" />
The <video>
element embeds a video, such as a tutorial or training movie, in a help page.
src
: Specifies the URL of the video. This attribute is required.
allowFullScreen
: Specifies whether the user can switch the video to full screen. Possible values are "true" or "false". This attribute is not supported for all video sources.
autoplay
: Specifies that the video will start playing as soon as the help page loads. Possible values are "true" or "false". This attribute is not supported for all video sources.
startTime
: Specifies, in seconds, from which point to start playing the video.
Presents a paragraph in a help page.
<p>This is some text in a paragraph.</p>
The <p>
element defines a paragraph.
Text inside a paragraph can be decorated in the following ways:
<strong>
element<em>
element<del>
element<u>
elementThese decorations can be combined. For example, make a fragment of text that is both bold and underlined.
Presents a bulleted list in a help page.
<ul>
<li>Coffee</li>
<li>Tea</li>
<li>Milk</li>
</ul>
The <ul>
element defines a bulleted list.
Use the <ul>
element together with the <li>
element to create bulleted lists.
Presents a numbered list in a help page.
<ol>
<li>First step</li>
<li>Second step</li>
<li>Third step</li>
</ol>
The <ol>
element defines an ordered (numbered) list.
Use the <ol>
tag together with the <li>
element to create numbered lists.
Presents a collapsible section in a help page.
<collapsible title="This is a Section">
<p>This is a paragraph inside a section</p>
<img src=smiley.gif" title="This is an image inside a section" />
</collapsible>
The <collapsible>
element defines a section of content that the user can view or hide on demand.
collapsed
: Specifies whether the section is collapsed or expanded initially. Possible values are "true" (collapsed) or "false" (expanded).Presents a link in a help page.
Link to a website that opens in a new browser window:
<a href="https://www.microsoft.com" target="_blank">Microsoft Home Page</a>
Link to another help page:
<a href="./LearnMore">Learn More</a>
The <a>
tag defines a link, which allows the user to navigate from a help page to a website, or to another help page.
href
: Specifies the URL of the website or help page to which to navigate. This attribute is required.target
: Specifies where to open the linked URL.
_self
, the link is assumed to be to another help page and it's opened in the help browser._blank
, the link is opened in a new browser window._top
, the link is opened in the current browser window.iframe
, the link is opened in that iframe.Presents a coach mark in a help page.
<coachmark target="#my-html-button">Click to highlight the HTML element with id [my-html-button]</coachmark>
A coach mark is an interactive element that can be used to draw the user's attention to a specific point in the UI of the application hosting the help browser.
target
: CSS selector that specifies the HTML element over which the coach mark will be shown. This attribute is required.Presents a balloon in a help page.
<balloon target="#my-html-button" title="This button submits the form" details="Please click this button to continue and submit the form">Click to show a balloon over the HTML element with id [my-html-button]</balloon>
A balloon is an interactive element that can be used to help the user perform an action in the UI of the application hosting the help browser.
target
: CSS selector that specifies the HTML element over which the balloon link will appear. This attribute is required.title
: Specifies the title of the balloon.details
: Specifies the content to show inside the balloon.Events
Power BI DataViz World Championships
Feb 14, 4 PM - Mar 31, 4 PM
With 4 chances to enter, you could win a conference package and make it to the LIVE Grand Finale in Las Vegas
Learn moreTraining
Learning path
Use advance techniques in canvas apps to perform custom updates and optimization - Training
Use advance techniques in canvas apps to perform custom updates and optimization
Certification
Microsoft Certified: Power Platform Developer Associate - Certifications
Demonstrate how to simplify, automate, and transform business tasks and processes using Microsoft Power Platform Developer.