> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omneo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuring lists

> What the Profile Portal lists pages show, how to add them to the menu, and the settings and copy you can change.

The Profile Portal lists pages show every [product list](https://docs.omneo.io/concepts/lists/overview.md) a Profile has, such as a wishlist or gift registry, and let the customer remove items. The pages are available for every brand. To make them visible, add a menu item that links to them. Your Omneo account manager makes the configuration changes on this page.

> [!NOTE]
>
> This page covers the Profile Portal hosted at `{tenant}.profileaction.io`, or your own domain pointed at it. The Profile Portal at `me.{tenant}.getomneo.com` is configured differently and is not covered here.

## What the lists pages show

| Path | Shows |
| - | - |
| `/lists` | Every product list on the Profile, newest first, 10 per page with **Previous** and **Next** buttons. Each row shows the image of the highest-priced item, the list name, the date it was created, the number of items, and the store that manages the list when one is set. |
| `/lists/{list_id}` | One list. The header shows the item count, the last updated date, the created date, and the managing store. Each item shows its image, price, discounted price, name, quantity, and a **Remove** button. The store's name, address, phone, and email appear below the items when the list has a store. |

Customers cannot add items, create lists, or share a list from the Profile Portal. Those actions happen on your own site through the Lists API. See [Shopify Lists](https://docs.omneo.io/extensions/shopify/lists.md) for a storefront example. For all Profile Portal paths, see [Routes and deep links](https://docs.omneo.io/experiences/profile-portal/routes.md#lists).

## Add lists to the menu

The `/lists` path works for every brand, but it does not appear in the Profile Portal until a menu item links to it. Ask your Omneo account manager to add an item to the menu on the home screen:

| Setting | Value |
| - | - |
| `title` | The menu label, for example `Wishlist` or `Your lists` |
| `url` | `/lists` |
| `icon` | The name of a built-in icon, for example `Heart`. To use your own icon, supply it as an SVG with your brand assets, set `icon` to its file name without `.svg`, and add `isCustom: true`. |

```json theme={null}
{
  "title": "Wishlist",
  "url": "/lists",
  "icon": "Heart"
}
```

A list's `id` is different for every Profile, so a menu item cannot link to one customer's wishlist directly. The menu item opens `/lists`, and the customer selects the list from there.

To open the lists pages from a Shopify theme, see [Opening a path from Shopify](https://docs.omneo.io/experiences/profile-portal/routes.md#opening-a-path-from-shopify).

## Display settings

| Setting | Effect | Default |
| - | - | - |
| `hideFields` | Set to `["itemCount"]` to hide the number of items on each row of `/lists`. `itemCount` is the only supported value. | Item count shown |
| `currencyPrefix` | Text shown before the `$` sign on item prices, for example `AU` shows `AU $120`. | No prefix |
| `disableButton` | Set to `true` to hide the **Discover more online** button below a list's items. The button is always hidden when the Profile Portal is embedded in another site. | Button shown |

## Which lists appear

The `/lists` page shows every product list on the Profile, whatever its [List Definition](https://docs.omneo.io/concepts/lists/list-definitions.md). No setting limits the page to certain lists or List Definitions. If your customers have more than one type of list, such as a wishlist and a gift registry, all of them appear on `/lists`.

## Copy you can change

Override any of these in your language file. Each one falls back to the default shown.

| Key | Where it appears | Default |
| - | - | - |
| `lists.title` | `/lists` page title | Your Lists |
| `lists.subtitle` | `/lists` page subtitle | Review your existing lists |
| `lists.emptyState.title` | `/lists` when the Profile has no lists | No lists yet |
| `lists.emptyState.subtitle` | Both empty states: `/lists` with no lists, and a list with no items | Once you make your first list, you can review all the details here. (no lists) / Items added to this list will be visible here (no items) |
| `lists.emptyState.items.title` | A list with no items | No items yet |
| `lists.item.error.title` | `/lists/{list_id}` when the list cannot be loaded | List not found |
| `lists.item.error.subtitle` | Same as above | We couldn't find a list matching this ID. Try returning to the list list and tapping on an item for more information. |

`lists.emptyState.subtitle` is used by both empty states, so overriding it changes the text in both places.

The header text on a single list (item count, last updated, created, and managing store) cannot be changed.

See [Configuring Profile Portal](https://docs.omneo.io/experiences/profile-portal/configuration.md) for how other Profile Portal settings are managed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.