# Lexicon

> Keep ClickClacks data tidy with Lexicon: describe, tag, verify and hide events and properties, set property types, merge duplicate event names, and see where each one is used.

- Canonical URL: https://clickclacks.io/docs/guides/lexicon
- Section: Product guides
- Last updated: 2026-09-26

Lexicon is the dictionary of your data: what each event and property means. Every picker in ClickClacks reads from it, so an hour spent here makes every report easier for the whole team.

## When to use it {#when}

- New teammates keep asking what `ob_step_3` means.
- Two names for the same thing crept in, such as `Signed Up` and `signup_completed`.
- Old test events clutter every picker.

## Browse your data {#browse}

Open **Lexicon** under Data. It has three tabs: **Events**, **Event properties** and **Person properties**. Each tab lists the name, a description, how much it is used (events in the last 30 days, or the share of recent events for a property), when it was first and last seen, and where it is used.

Search matches names, descriptions and tags. Filter by **All**, **Verified**, **Not verified** or **Hidden**, or click a tag to show only items with it.

## Describe, tag, verify, hide {#edit}

Click a row to open it:

- **Description**: up to 500 characters. It saves when you leave the field, or with ⌘/Ctrl + Enter.
- **Tags**: up to 10 short, lowercase tags, such as `onboarding` or `billing`. Press Enter or a comma to add one.
- **Verified**: pickers show a check next to it, so people know it is the right one to use.
- **Hidden**: left out of pickers. Reports that already use it keep working.
- **Used in**: links to every saved funnel, insight, retention definition, board, experiment, alert and segment that names it.

> **Who can edit**
>
> Editing needs the Manage Organization Settings permission, which Owners have. Everyone else can read everything here.

## Property types {#types}

Each property shows an inferred type, such as _Inferred · Text_. Set it to **Number**, **Text**, **True / false** or **Date** if the guess is wrong. The type decides which [filter operators](https://clickclacks.io/docs/guides/filters.md#operators) are offered. A number property gets greater than, less than and between, and a date gets before and after.

## Merge duplicate events {#merge}

On an event, under **Merged names**, use **Merge another event into this one**. From the next refresh, reports count the merged name as this event, and pickers show one entry with a _+1 merged_ chip.

Stored events keep their original names, so **Unmerge** restores everything exactly. System events can’t be merged.

## What changes in pickers {#pickers}

- Hidden events and properties drop out. One you had already picked stays.
- Merged names fold into their main event.
- Verified items show a check, and properties show a type glyph.
- Descriptions appear as a second line or a tooltip, and search matches them.

This applies to the event pickers in Insights, Funnels, Events and segments, and to the property filter builder.

## Tips and gotchas {#tips}

- **Lexicon doesn’t rename events.** To fix a name at the source, change what your code sends, then merge the old name into the new one.
- **Start with the busiest events.** Describe and verify the ones with the most activity in the last 30 days first.

## Recipes {#recipes}

### Clean up two names for sign-up.

1. Open **Lexicon** › **Events** and search `sign`.
2. Open the name you want to keep, such as `Signed up`.
3. Under **Merged names**, merge `signup_completed` into it.
4. Turn on **Verified** and add a description: _Fires once, when the account is created._

### Hide test events from everyone’s pickers.

1. Search for `test`.
2. Open each test event and turn on **Hidden**.

They disappear from pickers. Any report that already used them keeps working.

### Make “seats” filterable as a number.

1. Open **Event properties** (or **Person properties**) and find `seats`.
2. Set its type to **Number**.

Filters on `seats` now offer greater than, less than and between, so _Seats > 50_ works.

## Related {#related}

- [Filters, dates and comparisons](https://clickclacks.io/docs/guides/filters.md)
- [Events and identify](https://clickclacks.io/docs/events.md): Naming events well from the start.
- [Events explorer](https://clickclacks.io/docs/guides/events.md)
- [Insights](https://clickclacks.io/docs/guides/insights.md)