> ## 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.

# Lists Overview

Lists in Omneo allow customers to create personalised product catalogues linked to their profile. Lists bridge the gap between online browsing and in-store shopping, enabling staff to see what a customer has saved and customers to access their lists from any touchpoint.

## What lists are used for

| Use case            | Description                                                        |
| ------------------- | ------------------------------------------------------------------ |
| **Wishlists**       | Products a customer wants to purchase in the future                |
| **Gift registries** | Products a customer wants as gifts (wedding registry, baby shower) |
| **Style guides**    | Curated collections a customer has built with staff                |
| **"New to you"**    | System-generated lists of products the customer hasn't seen before |

## Key characteristics

* Lists are linked to a **known customer profile**
* Lists can be **viewed and edited** from both online (Profile Portal, SDK) and in-store (Clienteling) surfaces
* Lists can be **shared**: generating a shareable link for gift registries
* Lists support **custom fields** for brand-specific metadata per list item
* A customer can have **multiple lists** of different types simultaneously

## List structure

A list contains:

* **List metadata**: name, type, notes, privacy settings, expiry
* **List items**: individual product references with quantity, notes, and status
* **Custom fields**: brand-defined additional data per list or per item
* **Reservations**: items that have been reserved for purchase

## How lists work in-store

Staff using Clienteling can view a customer's lists, add items during a consultation, and mark items as purchased. This creates a continuous handoff between what a customer saved online and what happens in store.

## List definitions

List types are configured as **List Definitions**: templates that define the structure and rules for a particular list type. See [List Definitions](/concepts/lists/list-definitions) for details.

<CardGroup cols={2}>
  <Card title="List Definitions" href="/concepts/lists/list-definitions" icon="list">
    Configure list types and their rules.
  </Card>

  <Card title="New to You" href="/concepts/lists/new-to-you" icon="sparkles">
    System-generated personalised product recommendations.
  </Card>
</CardGroup>