# User Guides

By default, all devices use the same provisioning/claiming instructions, but occasionally, the device may require a specific Installation Guide, Troubleshooting link or Device Preparation Instructions. You can set them up for each Template separately:

1. Go to Template
2. Open the User Guides tab
3. Click on the item you’d like to modify

*You can reset the Guides to default by clicking the Reset To Default button*.

> This feature is available with our Enterprise plan. [Contact Sales](https://blynk.io/contact-us-business)

<div align="left"><figure><img src="/files/88q8S8gVMuRYoGYJqBnT" alt=""><figcaption><p>User Guides</p></figcaption></figure></div>

### Device Installation Guide

<div align="left"><figure><img src="/files/Z7bu3xCxUc1q7YXdzX05" alt=""><figcaption><p>Device Installation Guide</p></figcaption></figure></div>

To ensure your guide is clear and well-structured, we support Markdown syntax. Below are the essential Markdown elements you can use:

#### **Headlines**

* Use **Headlines** to structure your guide into individual steps.
* Start each main step with an H1 headline (`#`).
* For sub-steps, use H2 (`##`) and H3 (`###`) headlines.

**Example:**

```
# Step 1: Unbox the Device
## Step 1.1: Check the Contents
## Step 1.2: Inspect the Device

# Step 2: Power On the Device
```

#### **Lists**

* Use **Ordered Lists** for steps that must follow a specific order.
* Use **Unordered Lists** for items that do not require a particular order.

**Example:**

```
# Step 3: Connect the Device

1. Plug in the power cable.
2. Connect the device to your Wi-Fi network.
    - Ensure your Wi-Fi is on.
    - Enter the Wi-Fi password when prompted.
3. Wait for the device to sync.

- Tools you might need:
    - Screwdriver
    - Wrench
    - Pliers
```

#### **Links**

* Use **Links** to provide additional resources or references.

**Example:**

```
For more details, visit the [official documentation](https://example.com/documentation).
```

#### **Images**

* Use **Images** to provide visual aids for better understanding.

**Example:**

```
# Step 4: Install the Software

![Installation Screen](https://example.com/images/installation-screen.png)
```

#### **Limitations:**

* 4000 characters max
* 10 steps max

### Device Activation Guide

<div align="left"><figure><img src="/files/SiLzEeIXuFRxgHo2mKZC" alt=""><figcaption></figcaption></figure></div>

To ensure your instructions are clear and well-structured, we support Markdown syntax. Below are the essential Markdown elements you can use:

#### **Headlines**

* Use H1 (`#`), H2 (`##`) and H3 (`###`) to structure your instructions.

#### **Lists**

* Use **Ordered Lists** for steps that need to follow a specific sequence.
* Use **Unordered Lists** for items that do not require a particular order.

#### **Links**

* Use **Links** to provide additional resources or references.

#### **Images**

* Use **Images** to provide visual aids for better understanding.

**Example:**

```
![activation-illustration-wl](https://static-image.nyc3.cdn.digitaloceanspaces.com/general/cloud-wifi.png)
# Make sure your device is ON and ready to be connected
- Put the device and smartphone close to each other
- Check that device is able to connect to the Internet
```

#### **Limitations:**

* 400 characters max

By using these Markdown elements, you can create a clear, structured, and informative Device Preparation Instructions.

### Troubleshooting link

Sometimes, users may need assistance during the device pairing. Provide a link that will help them get the device connected. *You can use `mailto:mail@example.com` where ‘*[*mail@example.com*](mailto:mail@example.com)*’ is your support contact if you need users to contact you directly, or you can also use `tel:` placeholder to trigger a phone call*.

#### **Limitations:**

* max length of the Action Title is 40 characters


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.blynk.io/en/blynk.console/templates/user-guides.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
