BeaconUser ManualFirst SetupCreate your first product

Create your first product

A product in Beacon represents one application you want to track — for example, your desktop app, your web app, or your back-end service. Most customers create one product per application they ship.

This page walks you through creating your first product. It takes about 1 minute.

Why products matter

Every event Beacon ingests is tagged with the product (and version) it came from. Products let you:

  • Filter dashboards and reports to a single application.
  • Apply different allowlists, properties, and retention rules per product.
  • See which application is generating which events when you ship multiple apps under one account.

You can create as many products as you need on every plan — there’s no per-plan product limit.

Step 1 — Open the Products page

In the sidebar, expand Settings and click Products.

If you have permission to manage products (default for the account creator), you’ll see a Create Product button in the top-right.

Step 2 — Fill in the form

Click Create Product. A modal appears with three fields:

FieldRequiredNotes
Display nameYesThe human-readable name. Appears in dropdowns and headers throughout Beacon. Example: “Inventory Manager.”
SlugYesA URL-safe identifier used in the API and SDK config. Must start with a lowercase letter or number and contain only lowercase letters, numbers, dots, hyphens, or underscores (^[a-z0-9][a-z0-9._-]*$). Example: inventory-manager or inventory.manager.
DescriptionNoOptional notes about what this application does. Helpful when team members are working with multiple products.

The slug is what your SDK will send as source_app (.NET / C++) or sourceApp (JS) when it ingests events — match exactly. The slug cannot be changed after creation, but the display name and description can.

Step 3 — Submit

Click Create. On success:

  • A green toast appears: “Product Display Name has been created.”
  • You’re navigated to the product’s detail page.

If a product with the same slug already exists in your organization, you’ll see “A product with this slug already exists” inline on the slug field. Pick a different slug.

Step 4 — Note the slug

Write down or copy the slug. You’ll use it when configuring your SDK in Install an SDK — the SDK’s source_app (or sourceApp) value must match exactly, otherwise events won’t be associated with this product.

What’s next

You have a product. Next, generate an API key the SDK will use to authenticate when sending events.

Generate an API key

Common questions

Should I create one product per application, or one product per release channel? One per application is the convention. Use the SDK’s source_version field to distinguish releases, and use Beacon’s version-filtered analytics to compare versions side by side.

Can I rename a product after creating it? The display name and description, yes — open the product’s detail page and edit them. The slug, no — pick the slug carefully.

Can I delete a product? Yes, from the product’s detail page. Deletion is non-reversible and removes all events associated with that product. Use Archive instead if you want to soft-disable a product (note: as of this writing the Archive UI has been removed pending redesign — contact support if you need to soft-disable).