> ## Documentation Index
> Fetch the complete documentation index at: https://docs.honeycomb.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Dataset Markers

> Create, delete, and style markers scoped to a specific dataset to flag deployments, incidents, and feature flag changes within that dataset's views.

export const HnyIcon = ({alias, path, size = 16, iconColor}) => {
  const iconMap = {
    "home": "house.svg",
    "marker": "caretFilledDown.svg",
    "show-marker-options": "chatTextLeft.svg",
    "download": "arrowLineDown.svg",
    "trace-waterfall": "trace.svg",
    "show-query-details": "listDashes.svg",
    "table": "table.svg",
    "log-lines": "logLines.svg",
    "chart": "chartLine.svg",
    "show-settings": "gear.svg",
    "add": "plus.svg",
    "remove": "delete.svg",
    "persist": "caretDown.svg",
    "close": "close.svg",
    "copy": "copy.svg",
    "zoom-in": "magnifyingGlassPlus.svg",
    "zoom-out": "magnifyingGlassMinus.svg",
    "color-assignment": "drop.svg",
    "drag": "dots-six-vertical.svg",
    "drawer": "drawer.svg",
    "show-actions": "dotsThree.svg",
    "edit": "pencil.svg",
    "delete": "trash.svg",
    "move": "arrowsOutCardinal.svg",
    "show-legend": "circleInfo.svg",
    "usage-ok": "usageGood.svg",
    "usage-warning": "usageWarning.svg",
    "usage-danger": "usageDanger.svg",
    "open-query-builder": "query.svg",
    "home-menu": "house.svg",
    "query-menu": "query.svg",
    "boards-menu": "board.svg",
    "triggers-menu": "bell.svg",
    "slos-menu": "handshake.svg",
    "service-map-menu": "serviceMap.svg",
    "history-menu": "clockCounterClockwise.svg",
    "manage-data-menu": "cube.svg",
    "usage-menu": "usageGood.svg",
    "show-details": "dotsThreeVertical.svg",
    "resize-handle": "board-panel-resize-handle.png",
    "standard-dataset": "cube.svg",
    "trace-dataset": "cubeChat.svg",
    "all-datasets": "linkedSquares.svg",
    "share": "arrowBentRight.svg",
    "run-in-query-builder": "arrowSquareUpRight.svg",
    "link": "link.svg",
    "text": "text.svg",
    "receive": "arrowLineDown.svg",
    "process": "lightning.svg",
    "sample": "drop.svg",
    "send": "arrowLineUp.svg",
    "submit": "arrowUp.svg",
    "canvas-menu": "sparkle.svg",
    "canvas": "sparkle.svg",
    "private": "lockKey.svg",
    "shared": "people.svg",
    "expand": "caretDown.svg",
    "previous": "caretLeft.svg",
    "next": "caretRight.svg"
  };
  const iconBasePath = "/_assets/icons/";
  const iconPath = path || (alias ? `${iconBasePath}${iconMap[alias]}` : undefined);
  return <span className="hny-icon" style={{
    display: "inline-block",
    width: `${size}px`,
    height: `${size}px`,
    maskImage: `url(${iconPath})`,
    maskSize: "contain",
    maskRepeat: "no-repeat",
    maskPosition: "center",
    WebkitMaskImage: `url(${iconPath})`,
    WebkitMaskSize: "contain",
    WebkitMaskRepeat: "no-repeat",
    WebkitMaskPosition: "center",
    backgroundColor: iconColor || "var(--hny-icon-color)",
    verticalAlign: "middle"
  }} />;
};

Each Dataset allows you to define markers for use within it.

<Tip>
  You can create markers at both the Dataset and the Environment level.
  When you create a marker at the Dataset level, you can use it only within its associated Dataset.
  When you create a marker at the Environment level, you can use it across all Datasets in your Environment.
</Tip>

You can manage markers using both the Honeycomb UI and [Honeycomb API](/api/marker-settings/).

## What are Markers?

Markers are custom labels that you can add to your data to emphasize specific data points in time, such as when you change a condition, deploy code, or have an outage.

Markers display as vertical lines on graphs in Honeycomb to signal interesting occurrences within the context of your queries.

## Uses

Use markers to identify points in time, such as:

* deployments
* incidents
* activated or resolved Triggers
* enabled or disabled feature flags

<Tip>
  You should create a Dataset-level marker when the range of time is relevant only to the specific Dataset or Service.
</Tip>

## Change Marker Color

<Info>
  You must be a [Team Owner](/configure/teams/manage-permissions/) to change a marker's color.
</Info>

To change your marker color:

1. Log in to the Honeycomb UI.

2. Select the **Environments** label on the top-left, then select the appropriate environment.

3. In the left navigation menu, select **Manage Data**.

4. In the list, locate and select **Datasets**.

5. In the list, locate the dataset that contains the marker you want to edit, and select its name to view the available settings.

6. Select the **Markers** view.

7. In the list, locate the **Marker Type** you want to change, and select the desired color from the dropdown in the **Color** column. We will save your changes automatically.

## Add Markers From the UI

To create a marker from the Honeycomb UI:

1. In your query results, move your cursor over the graph to your desired time point.

2. Select your desired time point, which causes the graph menu options to appear.

3. Select **Add marker**. The **Add a Marker** modal appears.

   <Frame>
     <img src="https://mintcdn.com/honeycomb/ubU2dY8GwHCSzegF/_assets/images/markers/add-a-marker.png?fit=max&auto=format&n=ubU2dY8GwHCSzegF&q=85&s=015ec3770b6c951c05df6c08378c22d2" alt="Screenshot illustrating the 'Add a Marker' dialog box" width="557" height="500" data-path="_assets/images/markers/add-a-marker.png" />
   </Frame>

4. Enter the following information:
   1. A Message for your marker, such as "Deploy #299" or "Abnormal Spike in Products Page Traffic".
   2. A Type for the marker, such as "deploy" or "trigger".
      After creation, the type appears as a preface to the marker's message when viewing the marker details.
   3. The URL field is optional, but provides a great way for more context about the marker.
   4. Select the "Environment-wide" checkbox to apply this marker to **all** datasets in your environment.

5. When finished, select **Create** to add your marker to the graph.

<Tip>
  To add markers via a command line tool or further manage existing markers, use either `curl` or `honeymarker`, a lightweight marker management tool that provides a CRUD command line interface.
  Refer to our Markers documentation for more information.
</Tip>

## View Markers in the UI

Once created, markers appear on any queries that run within the same time period as the marker(s).

Each marker type can appear in its own color.

<Tip>
  To change dataset marker color, configure dataset markers in [Dataset Settings](/configure/datasets/manage-markers/#change-marker-color).
</Tip>

Hover over the Marker icon (<HnyIcon alias="marker" />) to view a marker's details.
A solid vertical line appears and a window displays the marker's name, description, and if applicable, a selectable URL.

To persist the marker's vertical line and information window, select the downward caret icon.
To close the persisted display, use the icon (<HnyIcon alias="close" />) that appears in the window after selection.

<Frame>
  <img src="https://mintcdn.com/honeycomb/ubU2dY8GwHCSzegF/_assets/images/markers/view-marker.png?fit=max&auto=format&n=ubU2dY8GwHCSzegF&q=85&s=ab461160f5f78aa363961db934c985a5" alt="Screenshot illustrating a selected marker and marker details" width="412" height="500" data-path="_assets/images/markers/view-marker.png" />
</Frame>

## Filter Markers in the UI

By default, Honeycomb shows environment markers in environment-wide queries and dataset markers in dataset queries.

Use **Filter Markers** to modify what markers appear in the query results.

To access **Filter Markers**, either:

1. Press `l` on your keyboard
2. Select the Marker options icon (<HnyIcon alias="show-marker-options" />) below the time picker in your query results, and select **Filter Markers**.

The Filter Markers modal appears.
Use to modify what markers appear based on:

1. on their value
2. whether or not markers of the opposite type (environment/dataset) are allowed
3. their marker type

<Frame>
  <img src="https://mintcdn.com/honeycomb/ubU2dY8GwHCSzegF/_assets/images/markers/filter-markers.png?fit=max&auto=format&n=ubU2dY8GwHCSzegF&q=85&s=32df2a601ceff4a04f6e5d5ded6c0994" alt="Screenshot illustrating the 'Filter Markers' dialog box for a dataset query" width="500" height="373" data-path="_assets/images/markers/filter-markers.png" />
</Frame>