# Get Started

### Installation Guides[​](https://docs.powerviz.ai/datepicker/get-started#installation-guides) <a href="#installation-guides" id="installation-guides"></a>

Installation guides contain the installation process and instructions for Filter. Please note that the installation process is the same across all the visuals. You can see the user guide [here](/powerviz/installation-guide.md).

#### Setup

After installing the Powerviz Filter visual in Power BI, follow these steps to set up your first filter:

**Step 1: Add the Filter to the Canvas:**

* Select and drag the Powerviz Filter from the visualization pane to the canvas.

**Step 2: Configure the Filter:**

* Drag and drop the desired data column into the Filter field to open the setup screen.
* Choose your preferred filter settings, including filter type, display mode, and any other customization options.

{% hint style="info" %}
If you prefer to skip the setup process, click the "X" icon in the top-right corner.
{% endhint %}

**Step 3: Finalize and Apply:**

* Once you've configured your preferences, the new filter will appear on the canvas.

<figure><img src="/files/bC8qLHexOwPCTXUsdRNS" alt=""><figcaption></figcaption></figure>

#### Field Requirements -

* [Category](#category)
* [Value](#value)
* [Default Selection](#default-selection)
* [Image Data](#image-data)&#x20;
* [Tooltip](#tooltip)
* [Title](#title)

<figure><img src="/files/trgcDFFjcvsWOvMhzr9c" alt="" width="164"><figcaption></figcaption></figure>

#### **Category:**

\[Compulsory] This field is essential for rendering the visual. The user must provide category data here to ensure the filter functions correctly.

#### **Value:**

\[Optional] Users can include numerical data in this field to enhance the filter's usability and provide additional information.

#### Default Selection -&#x20;

\[Optional] Accepts a boolean (0/1) type column or measure where 1 is true and 0 is false. This field allows multiple columns, but you can keep only one of them as the default selection.

Use the below steps to add a custom default selection column.

* Create a new measure or calculated column using the provided DAX formula. Enter 1 for default selection values and 0 for others.

```dax
SampleMeasure = 
VAR _category = MIN('Categories'[Category])
VAR Result = 
    IF(
        _category = BLANK(), 
        BLANK(), 
        SWITCH(
            TRUE(),
            _category = "Category1", 1,   // 1 for selected category
            _category = "Category2", 1,   // 1 for selected category
            0                              // 0 for other categories
        )
    )
RETURN
    Result

```

* Drag this column into the default selection field.
* Go to the default selection option in advanced settings.
* Select “based on field” from the dropdown.
* Hit Apply.
* Result: This value will always stay selected by default.

{% hint style="success" %} <mark style="color:green;">IMPORTANT NOTES</mark>

* <mark style="color:green;">Ensure that the custom column or measure is of numeric type (0/1).</mark>
* <mark style="color:green;">Avoid using count and count distinct as aggregation types for columns, as they will display a count of all rows as 1.</mark>
  {% endhint %}

Read this section to learn how to add a [default selection](/powerviz/filter/advanced-settings-introduction/default-selection.md).

#### Image Data&#x20;

\[Optional] To use the image styling feature, you need to drag a Base64 URL image field into the Image Data Bucket.&#x20;

#### Tooltip

\[Optional] Users can provide data in either numerical or text format for the tooltip. This data will be displayed when users hover over items in the visual, offering additional context or information

#### Title

\[Optional] To enable a dynamic title in your visual, the user can create and provide a measure that determines the title based on the selected filters or data. This measure will dynamically update the title according to the current state of the visual.

```dax
DynamicTitle = 
VAR SelectedCategory = SELECTEDVALUE('Categories'[Category], "Default Title")
RETURN 
    "Current Selection: " & SelectedCategory

```


---

# 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.powerviz.ai/powerviz/filter/get-started.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.
