> For the complete documentation index, see [llms.txt](https://v5docs.keyfax.biz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://v5docs.keyfax.biz/script-actions/markers.md).

# Markers

A marker records that something happened in a conversation. It shows the caller nothing and raises no work — it exists so that you can count it afterwards.

<figure><img src="/files/NDtDynxAOE3DDZKh67R2" alt="A marker open in the editor"><figcaption><p>A marker, and the code it is recorded under</p></figcaption></figure>

## What they are for

Anything you will later be asked "how often does that happen?" about:

* a safety warning was shown
* a vulnerability was declared
* self-help was offered and declined
* the caller was told about a known outage

Each is invisible at the time and valuable in a report six months later.

## Marker or databox?

A **databox** holds a value the conversation uses. A **marker** records that something occurred, for reporting.

If the script needs to act on it, use a databox. If you only need to count it, use a marker — it is cheaper, and it keeps the databox library about data rather than about history.

Markers are read back through [Reports](/reporting/reports.md).