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

# Collections

> Group related units into curated collections that visitors can browse in the viewer

Collections let you organize units into groups such as **City Studios**, **Penthouses**, or **Investment Units**. When a project has collections, visitors first see the collection list and can open a collection to browse its assigned units.

<Frame caption="Create and manage a collection from start to finish">
  <video controls playsInline preload="metadata" style={{ width: "100%" }}>
    <source src="https://mintcdn.com/planpoint/sOKHUfHCmYviVaUF/images/collections-workflow.mp4?fit=max&auto=format&n=sOKHUfHCmYviVaUF&q=85&s=40d7efb3f4e953064fbf86aac49ba1ce" type="video/mp4" data-path="images/collections-workflow.mp4" />
  </video>
</Frame>

<Steps>
  <Step title="Step 1 - Create a collection">
    Open your project, go to **Content**, and select the **Collections** tab. Click **+ New collection**, enter a name, and click **Create**.

    Use a clear, unique name because it is shown to visitors and used to connect units to the collection.

    <Frame caption="Open the Collections tab and select New collection">
      <img src="https://mintcdn.com/planpoint/sOKHUfHCmYviVaUF/images/collections-create.png?fit=max&auto=format&n=sOKHUfHCmYviVaUF&q=85&s=25903f7f64e784279c61fa4d5e715d50" alt="Project Collections tab with the New collection action highlighted" width="2610" height="1782" data-path="images/collections-create.png" />
    </Frame>
  </Step>

  <Step title="Step 2 - Assign floors and units">
    Click **Assign units** beside the collection. Units already in the collection are selected when the panel opens. Keep the units that should remain, select or deselect a floor to change all of its units at once, or select and deselect individual units. Use **Select all** when the collection should contain every unit in the project, then click **Apply collection**.

    Applying replaces the collection's membership with the units currently selected in the panel. Deselected units are removed from this collection. The collection name shown beneath a unit indicates its current assignment, and selecting a unit from another collection moves it automatically. To remove every unit, click **Clear**, then **Apply collection**.

    <Frame caption="Assign complete floors or individual units to the collection">
      <img src="https://mintcdn.com/planpoint/sOKHUfHCmYviVaUF/images/collections-assign-units.png?fit=max&auto=format&n=sOKHUfHCmYviVaUF&q=85&s=2f7f521fcacb4b5e6c3a2a28481f0c3f" alt="Assign units panel with individual units and a complete floor selected before applying the collection" width="2744" height="2062" data-path="images/collections-assign-units.png" />
    </Frame>
  </Step>

  <Step title="Step 3 - Customize the collection">
    Return to **Collections** and click **Edit** beside the collection. You can configure:

    * **Name**: the title visitors see.
    * **Link slug**: the final URL segment used for a pretty-path link, such as `city-studios` in `yoursite.com/pricelist/city-studios`.
    * **Image**: the collection cover image. Upload a PNG or JPEG within the dashboard's file-size limit.
    * **Message**: optional supporting text shown on the collection card.
    * **Featured**: visually emphasizes the collection in the viewer.

    Changes save as you make them. Click **Done** to close the panel.

    <Frame caption="Customize the collection name, link, image, message, and featured status">
      <img src="https://mintcdn.com/planpoint/sOKHUfHCmYviVaUF/images/collections-customize.png?fit=max&auto=format&n=sOKHUfHCmYviVaUF&q=85&s=64afc417fde1004a867db5998ad962b7" alt="Collection Edit panel with name, link slug, image, message, and featured settings highlighted" width="3406" height="1736" data-path="images/collections-customize.png" />
    </Frame>
  </Step>

  <Step title="Step 4 - Set the order and share a link">
    Drag collection rows up or down to control their order in the viewer. The unit count beside each collection helps you confirm that assignments are connected.

    Click **Copy link** to copy a URL that opens the viewer directly on that collection. For other linking options, see [Deep Linking to specific units](/link-units#linking-to-a-collection).

    <Frame caption="Reorder collections or copy a direct collection link">
      <img src="https://mintcdn.com/planpoint/sOKHUfHCmYviVaUF/images/collections-order-share.png?fit=max&auto=format&n=sOKHUfHCmYviVaUF&q=85&s=c2452c22da207a4451d3cd05be9d676e" alt="Collection list with drag ordering and Copy link actions highlighted" width="3632" height="2050" data-path="images/collections-order-share.png" />
    </Frame>
  </Step>

  <Step title="Step 5 - Check the viewer">
    Open the project viewer. The collection cards appear before the unit list. Select a collection and confirm that it contains the expected units and that its image, message, and featured styling appear correctly.

    <Frame caption="Visitors can browse the collection cards in the viewer">
      <img src="https://mintcdn.com/planpoint/sOKHUfHCmYviVaUF/images/collections-viewer.png?fit=max&auto=format&n=sOKHUfHCmYviVaUF&q=85&s=7a1579345595956e304e356f8dba18ec" alt="Viewer showing collection cards and the highlighted building floors represented by a selected collection" width="3018" height="1832" data-path="images/collections-viewer.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Collection assignments use the collection name. If you rename a collection after assigning units, open **Assign units**, select the affected floors or units, and apply the renamed collection again. Before deleting a collection, reassign its units in bulk or clear them individually from the **Units** tab because deleting the collection does not clear their existing assignment.
</Warning>

## Managing collections

* **Assign units**: edit the complete collection membership by selecting or deselecting floors and individual units, then apply everything in one action.
* **Reorder**: drag a row to change where the collection appears.
* **Copy link**: copy a direct link to the collection.
* **Edit**: update its name, link slug, image, message, or featured status.
* **Delete**: permanently remove the collection. Only project owners and administrators can delete collections.

You can still change one unit at a time from its **Edit** panel in the [Units](/units) tab.
