Open taxonomy

Contribute a token

You don't need to use Git. Describe a behavior in everyday language. If it belongs in the shared vocabulary, we add it to the intentLM™ Global Intent Taxonomy and ship it in the next SDK release.

Browse existing tokens →

Before you propose

  • Prefer mapping your page to an existing token (e.g. PRICING_VIEW = 102). New IDs are only for real gaps.
  • Company-only events should stay as local tokens in the dashboard — not in the global registry.
  • Auth / payment / admin security events must be emitted server-side (IDs 1001–1499), never from browser URL patterns.
  • Token IDs are immutable — we only add; we never renumber.

Propose a token

No Git, no pull request. Describe the behavior — we assign IDs and open the code change if approved.

Required — plain language, e.g. “Shopper opens the size guide before add to cart.”

What happens next

  1. Your proposal becomes a GitHub issue on the public SDK repo.
  2. Maintainers check for duplicates and pick the next free ID in the right namespace.
  3. If approved, we open the PR and publish it in intentlm-sdk.

More detail: Contribute taxonomy guide · Brand & credit.