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

# Collection - Listings

> Manage which listings belong to this collection, either manually or via smart rules

export const userRoleDefinition = "What a user can see and do. Each user has one built-in system role — Owner, Admin, Manager, or Member — and can also be assigned any number of custom roles you create with specific permissions. Effective access is the combination of all their roles.";

<Frame caption="Catalog > Collections > [Collection] > Listings">
  <img src="https://mintcdn.com/twicecommerce/Ab7tx7ih94KQsi0k/images/catalog-collection-listings.webp?fit=max&auto=format&n=Ab7tx7ih94KQsi0k&q=85&s=a4ec66146936db01d7cc970afed9f425" alt="Collection listings tab showing assigned listings or smart rules" width="1920" height="1080" data-path="images/catalog-collection-listings.webp" />
</Frame>

<Info>
  This view can look different dependent on your user role. <br />See [Visibility & Permissions](#visibility-and-permissions) for details.
</Info>

## Primary Purpose

The Listings tab controls which listings belong to this collection. For manual collections, you add or remove listings directly. For smart collections, you define the rules that determine membership.

<AccordionGroup>
  <Accordion title="Manual membership">
    Add and remove listings one by one. Useful for curated collections like featured products or editorial selections.
  </Accordion>

  <Accordion title="Smart rules">
    Define conditions (by tag, attribute, category, etc.) so listings are added automatically when they match. Match logic can require ALL or ANY of the rules.
  </Accordion>

  <Accordion title="Preview & sort order">
    Preview which listings will appear in the collection and define their display order on the storefront.
  </Accordion>
</AccordionGroup>

## Visibility and Permissions

Access to this view is controlled by your <Tooltip tip={userRoleDefinition}>user role</Tooltip>.

<Tabs>
  <Tab title="Visibility" icon="eye">
    | Feature         | Admin | Manager | Member |
    | --------------- | :---: | :-----: | :----: |
    | View listings   |   ✓   |    ✓    |    ✓   |
    | Edit membership |   ✓   |    ✓    |    ✗   |
  </Tab>
</Tabs>
