> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Message link reference

> Explains how DingTalk message links open, covering the PC sidebar or external browser, and mini program links.

This topic describes how message links are opened.

## Open a message link in the PC sidebar or an external browser

When a user clicks a URL in a message on the PC client, use the following format to control how the link opens:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
dingtalk://dingtalkclient/page/link?url=http%3A%2F%2Fwww.dingtalk.io&pc_slide=true
```

### Parameters

| **Parameter** | Description                                                                                 |
| ------------- | ------------------------------------------------------------------------------------------- |
| url           | The link to open. The value must be URL-encoded.                                            |
| pc\_slide     | - true: Open the link in the sidebar of the PC client. - false: Open the link in a browser. |

## Mini program links

A mini program can send a message that, when clicked, redirects the user to the mini program. The supported scenarios are as follows:

| App type                   | Work Notifications message | Organization group message | Plain message |
| -------------------------- | -------------------------- | -------------------------- | ------------- |
| Internal app               | Supported                  | Not supported              | Not supported |
| Third-party enterprise app | Supported                  | Not supported              | Not supported |
| Third-party personal app   | —                          | —                          | Supported     |

The link format used to redirect to a mini program is as follows:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
 eapp://page?query
```

Example: eapp\://pages/index/index?param1=aa\&param2=bb

### Parameters

* This link format is supported only when the message is sent by a mini program. It is not supported when the message is sent by a micro app.
* To ensure the redirection works as expected, publish the target mini program to the production environment.
* `page` indicates the page path of the mini program, such as `pages/index/index`. The path must be defined under `pages` in the `app.json` configuration file.

### Notes

To ensure the redirection works as expected, publish the target mini program to the production environment.

* `query` indicates the query parameters passed to the `onLoad` method of the page. For example, `param1=aa&param2=bb`. If a parameter value contains special characters, URL-encode the value.