Skip to main content

Glossary

Definitions of key terms used in the Hedges VIP platform.

A​

Acquire Legacy term. Former sidebar section. Sign-Up assets now live under Sign-Up QR List and Create → Poster QR; Coupons live under Create → Coupons; the Promoter program has its own top-level Promoters item.

Announcement Legacy term. See Push Promotion.

Audit Log A permanent, append-only record of all significant actions in the system. Includes who performed the action, what was changed, when it occurred, and why (if applicable). Cannot be modified or deleted.

ACTIVE (Card Status) A card that is currently valid and can be used for entry, redemption, and receiving coupons and push promotions.

Auditor Deprecated. The Auditor role has been retired. Anyone previously assigned the Auditor role has been promoted to Location Admin with the same location scope.

B​

Bar Redemption The process of validating a Customer's ticket at the bar and applying their VIP discount to their tab. Lives under Operations → Bar.

Barcode The scannable code displayed on a wallet pass, used for quick entry at the door. Typically a QR code format.

Business Date The date used for operational purposes, which may differ from the calendar date. Determined by a configurable cutoff time (typically 6am). Example: An entry at 2am may belong to the previous business date if the cutoff is 6am.

C​

Card Category A classification of card types, such as "VIP" or "Service Industry". Each category can have multiple tiers.

Card Design The Settings workspace where Org Admins customize wallet pass templates — colors, logo, layout, tier badges. Consolidates the former /wallet-editor and /wallet-templates pages.

Card Instance A specific VIP card issued to a Customer. A Customer can only have one active card per Organization.

Card Level (Tier) A rank within a card category (e.g., Sapphire, Gold, Platinum), each with different benefits and discounts.

Card Tier See Card Level.

CLV (Customer Lifetime Value) The total net revenue expected from a Customer over their entire relationship with your Organization, calculated as: (Average Spend × Visit Frequency × Lifespan) - Total Discounts. Previously called "MLV (Member Lifetime Value)".

Coupon A single-use promotion — a discount code issued to specific Customers or guest groups, either by the house (issuerType: HOUSE) or by a Promoter for commission (issuerType: PROMOTER). Lives under Create → Coupons. Formerly split between house-issued Offers and Promoter coupons; the two merged into this single unified entity in 2026-07. Also called a "Single Use Promotion". Distinct from Perks (tier-attached benefits) and Push Promotions (messages without a redemption).

Cover Charge An entry fee charged at the door. VIP cardholders may receive discounted or free cover as part of their perks.

Create Top-level sidebar section for everything an admin produces: Poster QR, Standing Benefits, Push Promotions, Coupons, and the Sign-Up Scanner. Replaces the former "Acquire" and "Engage" sections.

Credential Code See Card Code.

Card Code The unique alphanumeric identifier assigned to each VIP card, displayed below the barcode on wallet passes. Can be manually entered if scanning fails.

Customer The cardholder — anyone who receives a VIP card, service-industry card, push promotion, or coupon. The people your Organization is trying to attract and retain. Previously called "Member". Managed under Customers in the sidebar.

D​

Discount Rate The percentage of revenue given back to Customers as discounts. Calculated as: Total Discounts / Gross Revenue × 100.

E​

Engage Legacy term. Former sidebar section. Its tools now live under Create: Push Promotions (formerly Announcements), Coupons (formerly Offers / House Coupons), and Standing Benefits (formerly Perks).

Enrollment The process of signing up a new Customer for a VIP card. Can be done via Sign-Up QR code or by Staff using the Sign-Up Scanner.

EXPIRED_INACTIVITY (Card Status) A card that has been automatically expired due to no visits for 6+ months. The Customer must re-enroll to receive a new card.

External Sales The sidebar section covering money flowing through Promoters — commissions and Payouts. The people are always called "Promoters"; External Sales is the money-flow heading.

F​

First-Time Visitor A Customer visiting a venue for the first time. Useful for tracking new Customer acquisition.

Floor Legacy term. Former sidebar section for live in-venue operations. Hostess and Bar now live under Operations; the Sign-Up Scanner lives under Create; Live Activity lives under Insights.

Fraud Alert A system-generated warning indicating suspicious activity, such as repeated invalid scan attempts or impossible redemption patterns.

G​

Global Offer Legacy term. See Coupon — a coupon with no targeted audience is available to all VIP Customers, regardless of tier or location (unless location-specific).

Google Pay Google's digital wallet service for Android devices. Hedges VIP issues wallet passes compatible with Google Pay.

H​

Hostess Scanning The process of validating a Customer's VIP card at venue entry to grant access and issue a ticket. Lives under Operations → Hostess in the admin sidebar, or directly in the Hostess kiosk mode for Staff.

House Coupon Legacy term. Formerly the interim home of Offers in the portal, under Create → House Coupons. House Coupons merged with Promoter coupons into a single unified Coupon entity (issuerType: HOUSE); see Coupon.

I​

Inactivity Expiration Automatic card expiration after 6 months of no visits. Prevents inactive cards from accumulating in the system.

Insights Top-level sidebar section for looking back: Reports, Live Activity, and Activity Log.

K​

Kiosk Mode The Staff workspace mode set per device — Hostess, Bar, Sign-Up, or All. Determines which tools Staff sees when they open the app on that device (the Staff workspace lives at /workspace). Set at device first-launch and changeable by Location Admins.

L​

Location A specific physical venue within an Organization (e.g., "Main Venue", "Rooftop Lounge").

Location-Scoped Data or permissions that are limited to specific locations. Location Admin users see location-scoped data only. (Code identifier: LOCATION_ADMIN.)

Location Admin A user role with management access to specific assigned locations but not the entire Organization. Previously labelled "Location Manager".

M​

Manager Override The ability for managers to manually adjust discounts or approve exceptions. All overrides are logged with a required reason.

Member Legacy term. See Customer.

Multi-Tenancy The platform architecture that allows multiple independent Organizations to use the same system while keeping their data completely separate. The database column is still named tenantId for historical reasons, but the user-facing entity is always "Organization".

N​

Night Session A record of a Customer's visit to a location on a specific business date. Used to track visits and prevent duplicate ticket issuance.

O​

Offer Legacy term. Formerly a time-limited promotion sent to VIP Customers, such as "50% off drinks tonight 9-11pm", delivered via push notification to wallet passes. Offers no longer exist as a standalone feature: house discounts tied to a redemption are now Coupons (issuerType: HOUSE), and message-only time-boxed pushes are Push Promotions.

Operations Top-level sidebar section for live, in-venue tools: Hostess and Bar. Replaces the former "Floor" section. Visible to admins for oversight; Staff devices land directly inside one of these tools via kiosk mode.

Organization The top-level entity that owns a HEDGES account. An Organization has one or more Locations and is operated by Org Admins. The database column is tenantId for backwards compatibility, but every UI label and route says "Organization". Replaces the term "Tenant".

Org Admin A user role with full administrative access to all locations within a single Organization. Previously labelled "Tenant Admin". (Code identifier: ORG_ADMIN, renamed from TENANT_ADMIN.)

Outside Promoter / Outside Promotions Legacy terms. See Promoter.

P​

Perk An ongoing benefit associated with a card tier, such as a discount percentage or free cover charge. Configured under Create → Standing Benefits.

Perk Rule A configuration that defines which perks apply to which card tiers at which locations.

People Legacy term. The former "People" page has been split: venue employees are managed under Staff in the sidebar, and Promoters have their own top-level Promoters item.

Platform Admin The highest-level user role, with access to all Organizations and system-wide settings. Typically used by Hedges VIP platform staff. (Code identifier: PLATFORM_ADMIN.)

Promoter A user role for people who do not work for the venue but issue single-use promotions (coupons) for commission — for example, a hotel concierge. Previously labelled "Outside Promoter" (program: "Outside Promotions"; earlier still, "Concierge"). Managed under Promoters in the sidebar; their commissions and payouts appear under External Sales. (Code identifier: PROMOTER, renamed from OUTSIDE_PROMOTIONS.)

Push Notification An alert sent to a Customer's mobile device when a new coupon or push promotion is published or their wallet pass is updated.

Push Promotion A push message sent to Customers' wallet passes without a redemption attached. Lives in Create → Push Promotions. Previously called "Announcements".

R​

Redemption The act of using a ticket at the bar to receive a VIP discount on drinks.

Redemption Rate The percentage of issued tickets that are actually redeemed at the bar.

Return Visitor A Customer who has previously visited and is coming back. Higher return visitor rates indicate strong loyalty.

REVOKED (Card Status) A permanently canceled card, typically due to fraud or a banned Customer. Cannot be reactivated.

ROI (Return on Investment) A metric calculated as: (Net Revenue - Program Costs) / Program Costs × 100. Used to measure VIP program profitability.

Role A user's permission level in the system. UI labels: Platform Admin, Org Admin, Location Admin, Staff, Promoter.

S​

Sign-Up Assets Legacy term. The former combined workspace. Sign-Up Cards now live under Sign-Up QR List; Poster QRs are generated under Create → Poster QR.

Sign-Up Card A physical or digital card containing a Sign-Up QR. Previously called "Promo Card". Managed under Sign-Up QR List.

Sign-Up QR List The top-level sidebar item listing all Sign-Up QR codes (Sign-Up Cards) issued for in-venue enrollment. Poster QRs are generated under Create → Poster QR.

Sign-Up Scanner The Staff kiosk mode tool used to enroll Customers at the venue. Lives under Create → Sign-Up Scanner (route /sign-up; previously located at /promo).

Single Use Promotion Synonym for Coupon — a promotion that can be redeemed exactly once, issued by the house or by a Promoter.

Slug A URL-friendly identifier using only lowercase letters, numbers, and hyphens (e.g., "gold-vip"). Required when creating card categories and levels.

Staff A user role for anyone who works for the subscribing venue and issues cards, promotions, and coupons — hostess, bar, sign-up host. One role, multiple per-device kiosk modes. Previously called "Employee" and, earlier, "Promo". (Code identifier: STAFF, renamed from PROMO.)

SUSPENDED (Card Status) A temporarily disabled card, usually due to payment issues or rule violations. Can be reactivated.

T​

Targeted Offer Legacy term. See Coupon — target audience (specific Customer segments or card tiers) is configured per coupon.

Tenant Legacy term. See Organization. The database column tenantId is retained for backwards compatibility, but every UI label and user-facing surface uses "Organization".

Ticket A physical or digital token issued when a Customer enters a venue, used to redeem VIP discounts at the bar. Valid only for the issuing location and business date.

Ticket Token The unique code printed on a ticket, used to validate redemption.

Tier See Card Level.

V​

Validity Period The date and time range during which a coupon or push promotion is active and can be redeemed.

Visit A single entry by a Customer to a location on a specific business date. Multiple scans on the same business date count as one visit (re-entries).

Visit Frequency The average number of visits per Customer over a given time period. Key metric for engagement.

W​

Wallet Pass The digital card stored in Apple Wallet or Google Pay, containing Customer information, barcode, and VIP benefits.

Wallet Provider The backend service (Apple Wallet API or Google Pay API) that manages digital wallet passes.