> For the complete documentation index, see [llms.txt](https://help.cerby.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.cerby.com/cerby-web-app/collections/managing-your-subcollections/add-an-existing-collection-as-a-subcollection.md).

# Add an existing collection as a subcollection

To add an existing collection as a subcollection, you must complete the following steps:

{% hint style="danger" %}
**IMPORTANT:** Take the following into consideration when adding an existing collection as a subcollection:

* You can only add an existing collection as a subcollection if it already exists on the **Collections** page and you are the **Owner** of it.
* You can add a collection as a subcollection to multiple parent collections.
* You inherit user permissions from the parent collection when you add a collection as a subcollection.
  {% endhint %}

1. Log in to your corresponding [Cerby](https://app.cerby.com/) workspace.
2. Select the **Collections** option from the left navigation drawer. The **Collections** page is displayed.
3. Hover the mouse over the collection to which you want to add a subcollection. A menu of icons is displayed.
4. Click the **More** **options** (<img src="/files/dHze0SCo7aA748m0JAvZ" alt="" data-size="line">) icon. A menu is displayed.
5. Alternatively, click the **Settings** (<img src="/files/V5ThVIfGzPnKnWW37jAO" alt="" data-size="line">) icon from the corresponding collection card. The collection detail page is displayed with the **General** tab activated.
6. Activate the **Subcollections** tab. The **Subcollections** page is displayed.
7. Select the **Add subcollection** option. The **Add subcollection** dialog box is displayed with the list of existing subcollections.\
   ​**TIP:** You can also use the collection details page to add an existing subcollection by performing the following actions:
   1. Select the **Collection Settings** option from the drop-down list. The collection details page is displayed with the **General** tab activated.
   2. Activate the **Subcollections** tab. The list of subcollections is displayed.
   3. Click the **Add subcollection** button. The **Add subcollection** dialog box is displayed with the list of existing subcollections.
8. Select the name of the existing collection to be assigned as a subcollection. You can only select one collection at a time. If you can’t find the collection, you can use the search bar on top of the list.
9. Click the **Next** button. The **Is it ok to share this?** dialog box is displayed with information about the users who will also have access to the subcollection.
10. Click the **Confirm** button. The dialog box closes, and a success message box and the collections are now assigned as subcollections and listed in the **Subcollections** tab.

Now you are done.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.cerby.com/cerby-web-app/collections/managing-your-subcollections/add-an-existing-collection-as-a-subcollection.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
