# Collections

A collection in Umbraco Compose is a container for logically grouping related content. There may be one or more collections per [environment](/umbraco-compose/content-orchestration/environments.md). The content instances you ingest should be placed into an existing collection of your choice.

## Collection Considerations

When designing your content architecture in Umbraco Compose, you should keep in mind some collection principles.

Requests to the GraphQL API will always target a single collection for the root content that they return. However, it is also possible to retrieve other content in a single query if it is [referenced](/umbraco-compose/content-orchestration/referenced-content.md) from an item in the target collection.

GraphQL queries will return all items in the target collection unless they are explicitly [filtered out](/umbraco-compose/apis/graphql/filtering.md).


---

# Agent Instructions: 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:

```
GET https://docs.umbraco.com/umbraco-compose/content-orchestration/collections.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
