Blog · 28 January 2026

Naming Commerce Events So Redesigns Do Not Break History

Button-level names expire. Job-level names keep funnel history comparable.

Payment terminal and card on a counter

Prefer verbs like cart_item_added, shipping_option_selected, and payment_attempted over labels that mirror a temporary screen title.

Keep UI context in properties—template, experiment, gateway—so analysts can still debug without baking chrome into the event name.

Deprecate with aliases when engineering must rename. Silent renames are how year-over-year funnel charts become fiction.

Discuss this with us