# Collection

> Type in domain **Collections**

- HTML: [Collection.html](Collection.html)
- Raw SDL: [Collection.sdl](Collection.sdl)
- Covered by: [llms.txt](../llms.txt)

Implements: `Node`

## Fields

- `id`: `ID!` — `Collection` Id.
- `name`: `String!` — `Collection` name.
- `assets` (`limit`: `Int`, `page`: `Int`, `query`: `LibraryCollectionQueryInput`): `AssetItems!` — `Collection`'s `Asset` items list.
- `isPrivate`: `Boolean` _(deprecated)_ — `Collection`'s privacy state setting.
- `currentUserPermissions`: `CollectionUserPermissions!` — `Collection`'s permissions of the current `User`.

## Related mutations

- [`addCollectionAssets`](../mutation/addCollectionAssets.md)
- [`createCollection`](../mutation/createCollection.md)
- [`deleteCollection`](../mutation/deleteCollection.md)
- [`removeCollectionAssets`](../mutation/removeCollectionAssets.md)
- [`setCollectionAssets`](../mutation/setCollectionAssets.md)
- [`updateCollection`](../mutation/updateCollection.md)

## Reach via

Example queries that can return this type from the root `Query`.

### `library › collections`

```graphql
query LibraryCollections {
  library(id: "…") {
    collections(limit: 25, page: 1) {
      items {
        __typename
        assets {
          total
          page
          limit
          hasNextPage
          items {
            __typename
            title
            id
            alternativeText
            author
            attachments { id }
            availability { from }
            ... on Audio {
              previewUrl
              thumbnailUrl
              filename
              downloadUrl
            }
            ... on Document {
              previewUrl
              thumbnailUrl
              filename
              downloadUrl
            }
            ... on EmbeddedContent {
              previewUrl
              thumbnailUrl
              isDecorative
            }
            ... on File {
              previewUrl
              thumbnailUrl
              filename
              downloadUrl
            }
            ... on Image {
              previewUrl
              thumbnailUrl
              filename
              downloadUrl
            }
            ... on Video {
              previewUrl
              thumbnailUrl
              filename
              bitrate
            }
          }
        }
        currentUserPermissions {
          canAddAssets
          canRemoveAssets
        }
        id
        name
      }
    }
  }
}
```

Raw: [`LibraryCollections.sdl`](../examples/LibraryCollections.sdl)

### `brand › libraries › collections`

```graphql
query BrandLibrariesCollections {
  brand(id: "…") {
    libraries(limit: 25, page: 1) {
      items {
        collections(limit: 25, page: 1) {
          items {
            __typename
            assets {
              total
              page
              limit
              hasNextPage
              items {
                __typename
                title
                id
                alternativeText
                author
                attachments { id }
                availability { from }
                ... on Audio {
                  previewUrl
                  thumbnailUrl
                  filename
                  downloadUrl
                }
                ... on Document {
                  previewUrl
                  thumbnailUrl
                  filename
                  downloadUrl
                }
                ... on EmbeddedContent {
                  previewUrl
                  thumbnailUrl
                  isDecorative
                }
                ... on File {
                  previewUrl
                  thumbnailUrl
                  filename
                  downloadUrl
                }
                ... on Image {
                  previewUrl
                  thumbnailUrl
                  filename
                  downloadUrl
                }
                ... on Video {
                  previewUrl
                  thumbnailUrl
                  filename
                  bitrate
                }
              }
            }
            currentUserPermissions {
              canAddAssets
              canRemoveAssets
            }
            id
            name
          }
        }
      }
    }
  }
}
```

Raw: [`BrandLibrariesCollections.sdl`](../examples/BrandLibrariesCollections.sdl)

### `webhooks › project › collections`

```graphql
query WebhooksProjectCollections {
  webhooks(limit: 25, page: 1) {
    items {
      ... on ProjectWebhook {
        project {
          ... on DocumentLibrary {
            collections(limit: 25, page: 1) {
              items {
                __typename
                assets {
                  total
                  page
                  limit
                  hasNextPage
                  items {
                    __typename
                    title
                    id
                    alternativeText
                    author
                    attachments { id }
                    availability { from }
                    ... on Audio {
                      previewUrl
                      thumbnailUrl
                      filename
                      downloadUrl
                    }
                    ... on Document {
                      previewUrl
                      thumbnailUrl
                      filename
                      downloadUrl
                    }
                    ... on EmbeddedContent {
                      previewUrl
                      thumbnailUrl
                      isDecorative
                    }
                    ... on File {
                      previewUrl
                      thumbnailUrl
                      filename
                      downloadUrl
                    }
                    ... on Image {
                      previewUrl
                      thumbnailUrl
                      filename
                      downloadUrl
                    }
                    ... on Video {
                      previewUrl
                      thumbnailUrl
                      filename
                      bitrate
                    }
                  }
                }
                currentUserPermissions {
                  canAddAssets
                  canRemoveAssets
                }
                id
                name
              }
            }
          }
        }
      }
    }
  }
}
```

Raw: [`WebhooksProjectCollections.sdl`](../examples/WebhooksProjectCollections.sdl)

### `brands › libraries › collections`

```graphql
query BrandsLibrariesCollections {
  brands {
    libraries(limit: 25, page: 1) {
      items {
        collections(limit: 25, page: 1) {
          items {
            __typename
            assets {
              total
              page
              limit
              hasNextPage
              items {
                __typename
                title
                id
                alternativeText
                author
                attachments { id }
                availability { from }
                ... on Audio {
                  previewUrl
                  thumbnailUrl
                  filename
                  downloadUrl
                }
                ... on Document {
                  previewUrl
                  thumbnailUrl
                  filename
                  downloadUrl
                }
                ... on EmbeddedContent {
                  previewUrl
                  thumbnailUrl
                  isDecorative
                }
                ... on File {
                  previewUrl
                  thumbnailUrl
                  filename
                  downloadUrl
                }
                ... on Image {
                  previewUrl
                  thumbnailUrl
                  filename
                  downloadUrl
                }
                ... on Video {
                  previewUrl
                  thumbnailUrl
                  filename
                  bitrate
                }
              }
            }
            currentUserPermissions {
              canAddAssets
              canRemoveAssets
            }
            id
            name
          }
        }
      }
    }
  }
}
```

Raw: [`BrandsLibrariesCollections.sdl`](../examples/BrandsLibrariesCollections.sdl)