Storefront Links
Listify listens for special links anywhere on your storefront: navigation menus, banners, footers, buttons, or custom sections. No JavaScript and no special attributes are needed, just a standard link with the right hash. This makes them the easiest way to give customers access to the registry and wishlist from your existing theme.
Link hashes
Any <a> tag whose href contains one of these hashes is picked up automatically:
| Hash | Action |
|---|---|
#gift-registry | Toggle the registry hub (open/close) |
#gift-registry--create | Open the registry creation form |
#gift-registry--search | Open registry search |
#gift-registry--manage | Open registry management |
#wishlist | Toggle the wishlist |
A few behaviors worth knowing:
- Hashes work on page load too. Visiting
https://your-store.com/#gift-registry--createopens the creation form as soon as the page is ready, so you can use these in emails, social posts, or QR codes. - The bare
#gift-registrylink toggles. If the hub is already open, clicking it closes the hub. If a customer is mid-flow on an inner screen (for example registry settings), clicking it will not yank them back to the home screen. - Unknown variants are safe. A link like
#gift-registry--anythingsimply opens the hub home instead of breaking. - Disabled features stay inert. If you have disabled registries or wishlists in your Listify settings, their links do nothing rather than opening an empty view.
Adding links to your navigation menu
- In your Shopify admin, go to Online Store > Navigation.
- Open the menu you want to edit (for example "Main menu").
- Click Add menu item, give it a name like "Gift Registry", and paste the hash (for example
#gift-registry) into the Link field. - Save. The link works immediately on your storefront.
A typical setup for a store that leans on registries:
<a href="#gift-registry">Gift Registry</a>
<a href="#gift-registry--create">Create a Registry</a>
<a href="#gift-registry--search">Find a Registry</a>
<a href="#wishlist">My Wishlist</a>You can also place these directly in your theme's Liquid templates, sections, or any app that renders standard HTML links.
URL parameters for direct links
For full URLs (marketing emails, campaigns, link-in-bio pages), Listify also supports a listify-action query parameter that opens the matching view on page load:
| URL | Action |
|---|---|
https://your-store.com/?listify-action=open-registry | Open the registry hub |
https://your-store.com/?listify-action=open-create-registry | Open the registry creation form |
https://your-store.com/?listify-action=open-manage-registry | Open registry management |
https://your-store.com/?listify-action=open-wishlist | Open the wishlist |
These behave exactly like the hashes, but survive redirects and link tracking better, which makes them the safer choice for email campaigns.
Requirements
The main Registry theme app extension block must be active on your storefront. All link handling is loaded by that block, so links placed on pages without it will behave like normal anchors.