Public Listing Homepage.
A searchable directory of the programs you choose to publish, for operators whose product is a place full of businesses.
The Public Listing homepage is a dense, searchable directory of the programs you publish: loyalty cards, stamp cards, vouchers, and prepaid passes, in one place. A visitor lands, searches or filters, and finds the business they want among many. It is the fourth member homepage layout, beside Smart Wallet, Showcase, and Portal.
The same install can run either model. Smart Wallet runs isolated client loyalty under your brand. Public Listing runs public discovery when your product is a place. These are two strategies for one engine, and you switch between them in Settings → Homepage.
Who It Is For
Public Listing fits operators whose product is a place full of businesses:
- A shopping mall or a downtown district
- A business association or a tourism board
- A local marketplace where businesses pay to appear and publish their own cards
The test is the visitor's goal. When someone arrives wanting to find a business among many, a directory serves them better than a curated grid. When you run isolated client loyalty for an agency or a franchise, stay on Smart Wallet.
How It Differs from Smart Wallet
Both layouts draw from the same homepage permission stack and show only what you publish. They differ in the visitor's intent and the controls on the page.
| Smart Wallet | Public Listing | |
|---|---|---|
| Visitor's goal | Join a curated network | Find a business among many |
| Density | A handful of featured programs | A dense grid, paginated |
| Controls | Browse | Search, type filters, sort, load-as-you-scroll |
| Scale | Tens of programs | Hundreds, into the low thousands |
| Best for | Agencies, franchises, partner networks | Malls, districts, associations, marketplaces |
Public Listing reuses the existing program card components, so a partner's own card colors carry across. The chrome stays quiet.
What It Shows
- A unified grid of every published card, stamp card, voucher, and prepaid pass, loaded as the visitor scrolls
- Search with autocomplete across program and business names, navigable by keyboard
- Type filters: All, Loyalty, Stamps, Vouchers, Passes
- Three sorts that interleave all types instead of grouping by type:
- Newest (the default): most recently added programs first, by date
- Ending soon: programs whose validity ends soonest first, based on each program's end date (a loyalty card's expiration, a stamp card or voucher's "valid until"). Programs with no end date, such as prepaid passes, sort last
- Name: alphabetical by program name
- A calm empty state when nothing is published yet, and a no-results state when a search matches nothing
Search, filtering, and sorting run on the server across the whole published catalogue, not over the rows a browser happens to have loaded. The grid stays fast into the thousands.
Visibility: the Same Rules as Every Layout
Public Listing adds no new way to make a partner visible. It shows exactly what the three-tier visibility stack already publishes:
- The plan flag
has_cards_on_homepagesets the default for partners on that plan (off by default). - An admin override grants or revokes homepage publishing per partner.
- The partner's per-program "Visible on homepage" toggle chooses which items appear.
A program shows only while its owning partner is active and on an active network. The permission is re-checked every time the page renders, so a partner who loses homepage permission drops off at once, even with the per-program toggle still on. A program that would not appear on Smart Wallet will not appear here either.
Newly Registered Partners
When Public Listing is the active layout, a partner who self-registers gets homepage publishing (cards_on_homepage) enabled, so they can publish their own programs to the directory right away. The directory fills itself as businesses join.
- Existing partners are never changed when you switch to (or away from) this layout. Their settings stay as they were.
- Admins override per partner at any time under Partner Permissions: turn it on for a partner who registered earlier, or off for one who should not publish.
- Operators on other layouts are unaffected. Registration seeds this only when Public Listing is active.
Why It Is Not an Automatic Directory
A directory that lists everyone the moment they sign up brings back the problems the shared wallet was built to avoid: a sparse early list that looks amateur, and brand associations no one approved. Public Listing keeps the curation. You grant homepage permission per partner, partners choose which programs to publish, and you decide who appears together.
| Automatic directory | Public Listing |
|---|---|
| Everyone appears on signup | You grant permission per partner |
| Cold-start: three listings look bad | Start empty, add partners when ready |
| Uncontrolled brand associations | You choose who appears together |
| Search forced over a sparse, auto-filled list | Search and filters over a list you curated |
You keep partner isolation by default for clean sales pitches, with a public discovery surface when your model calls for one.
Related
- Homepage Layout , compare all four layouts
- The Shared Wallet Concept , isolation by default and why
- Partner Permissions , grant or revoke homepage publishing per partner
- Who Is This For? , business models and the layout each one wants