<!-- Source: https://docs.squirro.com/en/latest/technical/dashboards/visibility.html -->
# Visibility Conditions

Visibility conditions are an important means of choosing when and how certain sections or layers within Squirro’s [Dashboard Editor](dashboard-editor.md#dashboards-editor) are displayed.

When building complex dashboards, you’ll need to set visibility conditions to ensure that the correct layers (and their widgets) are displayed at the correct time.

## Layer Visibility Conditions

You can set visibility conditions for individual layers of your dashboard.

Visibility conditions are dependent on the rules you set within the _Visibility Condition_ editor.

These are found in the _Layer Properties_ panel, which can be accessed by following the steps below:

1. Open the _Dashboard Editor_ for your dashboard.
2. Click the layer you want to edit.
3. Click Visibility Condition + in the _Layer Properties_ panel.
4. Use the dropdown to select your configuration options.

## Visibility Condition Options

Squirro offers several options for setting visibility conditions, including the following:

- Query
- Selection
- Dashboard Store
- Label
- Spell check
- NLP Search Intent
- URL Parameter
- Communities
- Language

### Query

The _Query_ option allows you to set visibility conditions based on the query that is entered by the user.

You can choose based on the options shown in the drop-down menu shown below:

[![Query visibility condition selection options](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/vc-query-options.png)](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/vc-query-options.png)

In the example below, a rich text widget is contained within a layer that is set to be visible when the query contains the word _Covid_, as it contains a corporate policy notice about which data sources can be used for Covid research.

[![Query visibility conditions](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/vc-query.png)](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/vc-query.png)

### Label

The _Label_ option allows you to set visibility conditions based on the labels that are applied to the query.

In the example below, the layer is visualized when either the label `United States` or its country code is selected:

[![Label visibility conditions](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/vc-label1.png)](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/vc-label1.png)

### Dashboard Store

To learn more about using the _Dashboard Store_ to visualize layers, see [Dashboard Store](dashboard-store.md#dashboards-store).

### Spell Check

This option allows you to show or hide layers based on whether the user’s query has an associated spelling suggestion.

In the example below, a layer is set to be visible only when the query does not have a spelling suggestion. This is because the layer contains widgets that allow the user to drill down further into the query, and that option should not be presented if the query is misspelled.

[![Spell Check visibility conditions](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/vc-spell.png)](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/vc-spell.png)

### NLP Search Intent

This is primarily used as a boolean “Is there a search? Yes or No” option that allows you to show or hide layers based on whether or not a search has been performed.

In the example below, a list of communities is shown only when the NLP Search Intent is set to _is not empty_, meaning that a search has been performed. The idea is to show a list of associated communities only after a search has been performed.

[![Spell Check visibility conditions](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/vc-nlp.png)](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/vc-nlp.png)

### URL Parameter

This option allows you to set visibility conditions based on the URL parameters that are passed to the dashboard. So, if the dashboard is opened from an external source, an email Newsletter for example, you can set certain layers to either show or hide.

### Communities

This is a boolean _are subscribed_ or _are not subscribed_ option that allows you to visualize layers based on [Communities](../communities/index.md#communities).

## Widget Visualization Options

Individual widgets can have unique visualization options.

While they relate to what is displayed by the widget, they are not related to visibility conditions.

These are found under the _Visualization_ section of the _Widget Properties_ panel, as shown in the example _Tabs_ widget below:

[![Visualization Panel including Visibility Options](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/visualization-panel.png)](https://s3.amazonaws.com/download.squirro.net/docs/technical/dashboards/visualization-panel.png)

## Visualizing Sections

Sections cannot be hidden or shown based on visibility conditions.

If a section contains layers that are hidden, the section will not be displayed.
