# How to build a link to a Kanban

Link to a kanban can be built in two ways:

* Combine relative or absolute URL of kanban page with necessary parameters
* Use **BUILDDASHBOARDLINK** function

### Use of kanban page URL

This way is suitable for **URL/Navigate actions:**

<img src="/files/4wPwER35ZPOEnLgDDBwE" alt="" class="gitbook-drawing">

* Add an "**URL**" type [handler](/standard-kanban/tools/configuring-handlers.md) to necessary kanban element.
* Set URL **Value** to relative or absolute path to kanban page or component:
  * Absolute path depends on server/organization you refer to.
  * Relative path may depend on page structure and will refer to the current server/organization; e.g., relative path can be like this: **/lightning/cmp/c\_\_KanBanComponent**
* Select which browser window the page will be opened in - **the same** (will go out of kanban) or **new window/browser tab**.
* Add the necessary parameters.

Parameters for Kanban Component, used in this example, are:

* **c\_\_style** = some CSS styles, that will be applied to Kanban container;
* **c\_\_variables** = JSON with variables that should be passed to Kanban opened (optional);
* **c\_\_kanbanId** = ID of Kanban to open (may be set directly or via [merge fields](/standard-kanban/tools/using-merge-field-picker.md));

<img src="/files/3GyEy0rUnhjvQvAooNlK" alt="" class="gitbook-drawing">

### Use of BUILDDASHBOARDLINK function

This way is good for places where a link should be generated as HTML, instead of script-driven actions. For example, to build links in email messages.

The BUILDDASHBOARDLINK function can be selected via merge field picker and should be called in this way:

<mark style="color:red;">`BUILDDASHBOARDLINK(dashboard_id, variables, styles, as_html_tag_optional, text_optional)`</mark>

The parameters are:

* **dashboard\_id** = ID of Kanban to open
* **variables** = JSON with variables (in quotes '...') that should be passed to Kanban opened (optional; set to null, if not needed)
* **styles** = some CSS styles, that will be applied to Kanban container, in quotes ('...')
* **as\_html\_tag\_optional** = true, false or null (that will be equal to false) - asks system if generate link as text, or as \<a>...\</a> HTML tag
* **text\_optional** = some text or null - sets the substitute text, that will be content (not "href") of \<a> tag generated

Function should be wrapped with FORMULA\[] operator and can be validated with [formula editor](/standard-kanban/tools/using-formula-editor.md).


---

# 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.flexikanban.ai/standard-kanban/using-kanban/how-to-build-a-link-to-a-kanban.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.
