# "Custom Help" - Is it help?

Hola.. :relaxed:

My friends!

Last month, my client announced the system run GO-LIVE. My client is using Power Platform to build their core system. 

The PM had asked me how we could create a document to guide or support the user use the system. The user will interact with the system to get support while still using the system seamlessly.

I found the **Custom Help** functionality on D365 and Power Platform and then tried using this.

## Enable "Help" functionality

We must enable Custom Help Pane and Guided Task in the System Admin setting as below.

<figure><img src="https://4233060750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhtQupP7ACZVtv3cCNCr%2Fuploads%2FQYzfvOZp9udcwI72BJNK%2Fimage.png?alt=media&#x26;token=16c8d281-fc65-411e-9f23-5712f2dddc5b" alt=""><figcaption><p>Enable Custom Help Pane and Guided Task</p></figcaption></figure>

If the option is disabled, please make sure the option **Custom help for customizable entities** has been turned off. (*Path: Power Platform Admin Center > Feature > under Help features).*

<figure><img src="https://4233060750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhtQupP7ACZVtv3cCNCr%2Fuploads%2FKG5tPgkP0hebuU3cd5lK%2Fimage.png?alt=media&#x26;token=62fc7b44-2623-4a87-bb92-0cd4809d3cf5" alt="" width="375"><figcaption><p>Custom help for customizable entities: Turn Off</p></figcaption></figure>

{% hint style="info" %}
You can enable custom help panes or customizable help, but not both at the same time.
{% endhint %}

After enabling, click on the "help" icon <img src="https://4233060750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhtQupP7ACZVtv3cCNCr%2Fuploads%2Ftz9O98rnl7eiD4u0Lh4L%2Fimage.png?alt=media&#x26;token=5cb4d148-b204-4032-b0fd-b3dadc8a6d70" alt="" data-size="line">>> The **Custom Help** pane will be opened.

<figure><img src="https://4233060750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhtQupP7ACZVtv3cCNCr%2Fuploads%2Fhd9C4uf5Lo5F8GdpSwlY%2Fimage.png?alt=media&#x26;token=525c8cfa-501e-42cb-8638-c1eee68f1e16" alt=""><figcaption><p>Open Custom Help pane</p></figcaption></figure>

## Creating "Custom Help" form App

Now, we can create a new custom help to guide the user using Lead Processing.

On the Application, you open the **Entity** and click on the "help" icon<img src="https://4233060750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhtQupP7ACZVtv3cCNCr%2Fuploads%2Ftz9O98rnl7eiD4u0Lh4L%2Fimage.png?alt=media&#x26;token=5cb4d148-b204-4032-b0fd-b3dadc8a6d70" alt="" data-size="line">. The Custom Help pane will be shown that's mean, you are creating Custom Help for this entity. \
As my sample, I will create Custom Help to entity **Lead.**

{% hint style="info" %}
The Custom Help is available for **View** and **Form.** If you want to show Custom help on view, you should open the main list view of a specific entity and then click icon<img src="https://4233060750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhtQupP7ACZVtv3cCNCr%2Fuploads%2Ftz9O98rnl7eiD4u0Lh4L%2Fimage.png?alt=media&#x26;token=5cb4d148-b204-4032-b0fd-b3dadc8a6d70" alt="" data-size="line"> to begin creating content.
{% endhint %}

After that, on the Custom Help Pane >> click on the icon <...> and then click **Edit**

<figure><img src="https://4233060750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhtQupP7ACZVtv3cCNCr%2Fuploads%2FBmYgVFkIGuetFxzaemzS%2Fimage.png?alt=media&#x26;token=5333dbea-9746-4ca1-8b93-fb448ec0b6a6" alt="" width="563"><figcaption><p>Edit Custom Help</p></figcaption></figure>

On Custom Help, you can input the content by yourself with many components and functionalities:

* Free form text
* Add a bulleted list and a numbered list
* Can insert Link, Image, Video
* Add a section to group the content

After clicking **Edit  >** the new pane will be opened. Then, you can input the content on that >> And click **Save** after finishing.

<figure><img src="https://4233060750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhtQupP7ACZVtv3cCNCr%2Fuploads%2Fx0V8VWUfDRn4XZg7S6an%2Fimage.png?alt=media&#x26;token=a12968c0-2688-4452-9184-3762294b99f8" alt=""><figcaption><p>Creating Custom Help on Lead entity</p></figcaption></figure>

## Security & Privilege

The Custom Help is an entity in Dataverse, that why you can set ***global permission (4/4 or Organization)*** for the user: create, read, write, delete, append and append to privileges on the **Help Page** entity.

<figure><img src="https://4233060750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhtQupP7ACZVtv3cCNCr%2Fuploads%2FyJoNHjvVY8jLHNU77Gmz%2Fimage.png?alt=media&#x26;token=11790a4d-972b-420a-96a5-eca240a65cd9" alt="" width="563"><figcaption><p>Security role for Help Page entity</p></figcaption></figure>

## How to deploy to another?

After creating the necessary Custom Help on the DEV environment, you just add these custom help records to your solution and prepare to deploy for another environment.

<figure><img src="https://4233060750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhtQupP7ACZVtv3cCNCr%2Fuploads%2Fjhjzq5q2DD7DfuLVS0C0%2Fimage.png?alt=media&#x26;token=a5750d3f-f2e9-40a7-bb9d-3bffee25d9f4" alt="" width="563"><figcaption><p>Help page component in solution</p></figcaption></figure>

After adding to the solution, you can click open the Help page record and edit as below.

<figure><img src="https://4233060750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhtQupP7ACZVtv3cCNCr%2Fuploads%2FoSqvVudyzGleT6lcXIla%2Fimage.png?alt=media&#x26;token=03aece1e-503f-457c-9fda-e3027b3ba165" alt=""><figcaption><p>Help page record</p></figcaption></figure>

## Check the result...

Now, I will log in with a different user will open the Lead form then use the custom help.

<figure><img src="https://4233060750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhtQupP7ACZVtv3cCNCr%2Fuploads%2FeQCSXE7wFd80362GVy9O%2F_help_checking.gif?alt=media&#x26;token=77314199-3df5-41d6-8f16-204dc933664b" alt=""><figcaption><p>Using Custom Help on Lead form</p></figcaption></figure>

<figure><img src="https://4233060750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhtQupP7ACZVtv3cCNCr%2Fuploads%2FDRZNbcJLdFFnRujeuBFi%2Fimage.png?alt=media&#x26;token=087b5eed-d1e0-4d90-a45e-01c53c900d22" alt=""><figcaption><p>Help 1</p></figcaption></figure>

<figure><img src="https://4233060750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhtQupP7ACZVtv3cCNCr%2Fuploads%2Fg0kP5ZYmuv3hGmXT8DMl%2Fimage.png?alt=media&#x26;token=6f5ead0b-a4f0-477c-8c44-3aea676f83a1" alt=""><figcaption><p>Help 2</p></figcaption></figure>

Hoping well...  :tada:

For more details from Microsoft as the [link](https://learn.microsoft.com/en-us/power-apps/maker/data-platform/create-custom-help-pages).

Thank you.\
\&#xNAN;**\[NTD]yns.asia**\ <mark style="color:red;">...</mark>[<mark style="color:red;">invite me a cup.</mark>](https://ko-fi.com/ntdyns/?ref=qr\&amp;v=2) :coffee: Thank you. :heart: