# Annotations

* [Annotation query](#annotations-annotationquery)
  * [Query Filter](#annotations-queryfilter)
  * [Time Range](#annotations-timerange)
  * [Tags](#annotations-tags)
  * [Limit](#annotations-limit)
* [Display](#annotations-display)
  * [Show user](#annotations-showuser)
  * [Show time](#annotations-showtime)
  * [Show Tags](#annotations-showtags)
* [Link behavior](#annotations-linkbehavior)
  * [Link target](#annotations-linktarget)
  * [Time before](#annotations-timebefore)
  * [Time after](#annotations-timeafter)

The Annotations panel shows a list of available annotations you can use to view annotated data. Various options are available to filter the list based on tags and on the current dashboard.

***

### Annotation query <a href="#annotations-annotationquery" id="annotations-annotationquery"></a>

The following options control the source query for the list of annotations.

#### Query Filter <a href="#annotations-queryfilter" id="annotations-queryfilter"></a>

Use the query filter to create a list of annotations from all dashboards in your organization or the current dashboard in which this panel is located. It has the following options:

* All dashboards - List annotations from all dashboards in the current organization.
* This dashboard - Limit the list to the annotations on the current dashboard.

#### Time Range <a href="#annotations-timerange" id="annotations-timerange"></a>

Use the time range option to specify whether the list should be limited to the current time range. It has the following options:

* None - no time range limit for the annotations query.
* This dashboard - Limit the list to the time range of the dashboard where the annotation list panel is available.

#### Tags <a href="#annotations-tags" id="annotations-tags"></a>

Use the tags option to filter the annotations by tags. You can add multiple tags in order to refine the list.

Note: Optionally, leave the tag list empty and filter on the fly by selecting tags that are listed as part of the results on the panel itself.

#### Limit <a href="#annotations-limit" id="annotations-limit"></a>

Use the limit option to limit the number of results returned.

***

### Display <a href="#annotations-display" id="annotations-display"></a>

These options control additional meta-data included in the annotations panel display.

#### Show user <a href="#annotations-showuser" id="annotations-showuser"></a>

Use this option to show or hide which user created the annotation.

#### Show time <a href="#annotations-showtime" id="annotations-showtime"></a>

Use this option to show or hide the time the annotation creation time.

#### Show Tags <a href="#annotations-showtags" id="annotations-showtags"></a>

Use this option to show or hide the tags associated with an annotation. *NB*: You can use the tags to live-filter the annotation list on the panel itself.

***

### Link behavior <a href="#annotations-linkbehavior" id="annotations-linkbehavior"></a>

#### Link target <a href="#annotations-linktarget" id="annotations-linktarget"></a>

Use this option to chose how to view the annotated data. It has the following options.

* Panel - This option will take you directly to a full-screen view of the panel with the corresponding annotation
* Dashboard - This option will focus the annotation in the context of a complete dashboard

#### Time before <a href="#annotations-timebefore" id="annotations-timebefore"></a>

Use this option to set the time range before the annotation. Use duration string values like “1h” = 1 hour, “10m” = 10 minutes, etc.

#### Time after <a href="#annotations-timeafter" id="annotations-timeafter"></a>

Use this option to set the time range after the annotation.

***