Listify

Registry Page

By default, Listify opens registries in a panel over your existing storefront. The Gift Registry Page block gives them a dedicated page instead, at a real URL you can link to, share, and send customers to from email.

It is the right choice if registries are a significant part of your business. Customers get a full-width experience with room for the hero image, the registry list, and search, rather than a panel.

Setting it up takes a couple of minutes. You build the page template in the theme editor — that part only you can do, since Listify cannot create theme files — and then Listify creates the page and assigns the template for you in one click.

The whole flow lives in the app under Settings > Theme blocks & buttons > Registry page. Follow it there and the steps below are only reference.

Before you start

The Gift Registry app embed must be turned on in your theme. Every Listify script is loaded from it, including the one that renders this page, so the Gift Registry Page block shows nothing without it.

To check:

  1. Go to Online Store > Themes and click Customize on your live theme.
  2. Click the App embeds icon in the left sidebar (the puzzle-piece toggle at the bottom).
  3. Confirm Gift Registry is switched on. If you turn it on now, click Save.

Step 1 — Open the theme editor

From your Shopify admin, go to Online Store > Themes, then click Customize on the theme you want to change.

If you would rather not edit your live theme directly, duplicate it first from the ... menu on the theme card and customize the copy. You can publish it once you are happy.

Step 2 — Create the page template

  1. At the top of the theme editor, open the template dropdown in the centre of the screen. It usually reads Home page.
  2. Choose Pages, then Default page.
  3. Open the dropdown again and click Create template.
  4. Name it listify-gift-registry, and leave Based on set to page.
  5. Click Create.

The editor now shows your new, empty page template.

The name is a suggestion, not a requirement. Listify finds your template by looking for the Gift Registry Page section inside it, so you can call it anything — and a template that merely shares the name but does not contain the section will not be picked up.

Step 3 — Add the Gift Registry Page block

Once the template exists, Listify can do this for you: go to Settings > Theme blocks & buttons > Registry page in the app and click Add section for me. It opens the theme editor with the block already inserted — you only have to click Save.

To do it by hand instead:

  1. In the left sidebar, click Add section.
  2. Scroll to the Apps group and choose Gift Registry Page.
  3. Remove the template's default page content section, so the registry is the only thing on the page. Click it in the sidebar and choose Remove section.
  4. Click Save.

The block renders a loading state in the editor preview and then the registry experience itself.

Step 4 — Give the section its full width

This is the step that most often needs attention, and it is worth understanding why.

When you add any app block, Shopify wraps it in a section of its own. That wrapper belongs to your theme, not to Listify, and most themes constrain it to the same centred column they use for regular page content. The registry then sits inside that column rather than using the width of the page.

Listify centres its own content inside whatever width it is given, so the page will always look correct. But if you want the hero image to run edge to edge, the wrapper has to allow it.

To change it:

  1. In the theme editor sidebar, click the section containing the Gift Registry Page block, not the block itself. They are separate rows, with the block nested underneath the section.
  2. Look through the section's settings for a width control. Themes name it differently: Width, Section width, Full width, Page width, or Container.
  3. Set it to the full-width option and click Save.

If your theme has no such setting, the section is fixed to the theme's content width and the registry will be centred inside it. This is a limitation of the theme rather than something Listify can override, since no app block can extend past the container its theme places it in. Your options are to pick a theme layout that offers a full-width section, or to leave it as is, which looks perfectly reasonable.

To make the content narrower instead, use the block's Custom CSS setting:

& {
  --lxd-container-max-width: 800px;
}

The default is 960px. The same setting exposes --lxd-container-gutter for the spacing at the page edges.

Step 5 — Create the page

Creating the page and assigning the template used to be two manual steps. Listify now does both at once.

In the app, go to Settings > Theme blocks & buttons > Registry page. Under Create the page you will see the URL the page will get, prefilled as /pages/gift-registry. Change the last part if you want a different URL, then click Create page.

Listify creates the page, assigns your template to it, and publishes it. It is live immediately at your-store.com/pages/gift-registry.

If the URL is already taken by another page, you will be told so and can pick a different one.

To do it by hand instead: go to Online Store > Pages, click Add page, set the title to Gift Registry, leave the body empty, and under Online store > Theme template in the right-hand column select your listify-gift-registry template. Click Save.

If you built the template on a duplicated theme, preview that theme rather than the live one.

Step 6 — Link to it from your navigation

A page nobody can find will not get used. Add it to at least one menu.

This is the one step Listify cannot do or check for you: reading and editing your menus needs a permission the app does not ask for, so it stays a reminder rather than a tick.

  1. Go to Online Store > Navigation.
  2. Open the menu you want to change, usually Main menu or Footer menu.
  3. Click Add menu item, name it Gift Registry, and in the Link field choose Pages, then your Gift Registry page.
  4. Click Save.

Header and footer menus are both worth doing. Customers looking for a registry tend to check the footer when the header has no obvious entry point.

For deeper links, such as sending customers straight to the registry creation form or to search, see Storefront Links. Those hashes work on this page too.

Troubleshooting

The page is blank, or shows only a loading spinner. The Gift Registry app embed is off. See "Before you start" above. This accounts for most blank pages.

The registry appears, but squeezed into a narrow column. The theme's section wrapper is constraining it. See Step 4.

The page shows my normal page content instead of the registry. The template is not assigned. Open the page in Online Store > Pages and confirm Theme template reads listify-gift-registry.

The app says my page is unpublished. The page exists but is hidden from shoppers. Open it in Online Store > Pages and set its visibility to Visible.

My changes are not live. If you built the template on a duplicated theme, it will not appear on your storefront until you publish that theme from Online Store > Themes.

The block is missing from the Apps list. Confirm Listify is still installed, and that you are editing a theme that supports app blocks (Online Store 2.0). Very old themes do not.