# Document > Type in domain **Assets** - HTML: [Document.html](Document.html) - Raw SDL: [Document.sdl](Document.sdl) - Covered by: [llms.txt](../llms.txt) Implements: `Node`, `Asset` ## Fields - `id`: `ID!` — `Asset` id. - `creator`: `User!` — The `User` who created the `Asset`. - `createdAt`: `DateTime!` — `DateTime` of the `Asset` creation. - `modifier`: `User` — The `User` who last modified the `Asset`. - `modifiedAt`: `DateTime` — `DateTime` of the `Asset` last modification. - `title`: `String!` — Title of the `Asset`. - `description`: `String` — Description of the `Asset`. - `alternativeText`: `String` — Alternative text for the `Asset`. Used by screen readers when the asset is not decorative. - `isDecorative`: `Boolean!` — Indicates whether the `Asset` is decorative and not meant to be read by screen readers. If true, alternative text is ignored. - `externalId`: `ID` — External Id of the `Asset`. - `tags`: `[Tag]` — List of `Tag` items linked to `Asset` - `metadataValues`: `[MetadataValue]` _(deprecated)_ — `MetadataValue` items linked to `Asset`. - `copyright`: `Copyright` — `Asset` copyright details. - `availability`: `DateTimeRange!` — `Asset` will be available only during the defined `DateTime` range. When `null` it represents an unspecified start and/or open-ended date. - `expiresAt`: `DateTime` — `Asset` available until date. - `author`: `String` — Represents the Author of the `Asset`. Example: Photographer Name. - `status`: `AssetStatusType!` — Represents the conversion status of the `Asset`. Example: FINISHED. - `relatedAssets` (`limit`: `Int`, `page`: `Int`): `AssetItems!` — Paginated list of `Asset` items related to `Asset`. - `revisions` (`limit`: `Int`, `page`: `Int`): `AssetRevisionItems!` — Paginated list of `AssetRevision` items for `Asset`, newest first. - `comments` (`limit`: `Int`, `page`: `Int`, `query`: `AssetCommentQueryInput`): `AssetCommentItems` — Paginated list of `AssetComment` items for `Asset`. - `currentUserPermissions`: `AssetUserPermissions!` — Current `User` `Asset` permissions. - `customMetadata`: `[CustomMetadata!]!` — List of `CustomMetadataProperty` items and values associated to `Asset`. - `workflowTask`: `WorkflowTask` _(beta)_ — The `WorkflowTask` this `Asset` is linked to. - `variants` (`limit`: `Int`, `page`: `Int`): `AssetVariantItems` — `AssetVariant` items of the asset. Only available for assets in icon and logo libraries. - `location`: `AssetLocation!` — `Location` of the `Asset`. - `previewBackgroundColor`: `RgbaColor` _(beta)_ — Background color of the `Asset` preview. - `filename`: `String` — Original filename of the `Asset` `File`. - `size`: `BigInt` — Size of the `Asset` `File` in bytes. - `extension`: `String!` — Extension of the `Asset` `File`. - `fileCreatedAt`: `DateTime` — `DateTime` of the `Asset` `File` creation. - `previewUrl` (`width`: `Int`, `height`: `Int`, `page`: `Int`): `Url!` — Preview `Url` which has optional `width`, `height` and `page` arguments. If parameters are not specified, a `Url` without any parameters will be returned. - `thumbnailUrl`: `Url` — Provides a `Url` for the custom user defined thumbnail or a system generated one when possible. - `downloadUrl` (`validityInDays`: `Int`, `permanent`: `Boolean`): `Url` — Signed `Url` to download the original `Document` type file. Is null if the asset is download-protected and there is no approved and still valid download request. - `focalPoint`: `[Float]` — `Document` focal point position. Example: `[0.4803, 0.4340]`. - `width`: `Int!` — `Document` width in pixels. - `height`: `Int!` — `Document` height in pixels. - `pageCount`: `Int` — `Document` total number of pages. - `attachments`: `[AssetAttachment]` — `Attachment` items linked to `Asset`. - `provenance`: `AssetProvenance` _(beta)_ — AI provenance read from the asset's current file, or `null` if none has been extracted yet. - `licenses`: `[License]` — `License` items linked to `Asset`. - `targets`: `[Target]` _(beta)_ — List of `Target` related to `Asset` ## Related mutations - [`createGuidelineDocument`](../mutation/createGuidelineDocument.md) - [`createGuidelineDocumentGroup`](../mutation/createGuidelineDocumentGroup.md) - [`createGuidelineDocumentLink`](../mutation/createGuidelineDocumentLink.md) - [`createGuidelineDocumentPage`](../mutation/createGuidelineDocumentPage.md) - [`createGuidelineDocumentPageCategory`](../mutation/createGuidelineDocumentPageCategory.md) - [`createGuidelineDocumentPageLink`](../mutation/createGuidelineDocumentPageLink.md) - [`deleteGuidelineDocument`](../mutation/deleteGuidelineDocument.md) - [`deleteGuidelineDocumentGroup`](../mutation/deleteGuidelineDocumentGroup.md) - [`deleteGuidelineDocumentLink`](../mutation/deleteGuidelineDocumentLink.md) - [`deleteGuidelineDocumentPage`](../mutation/deleteGuidelineDocumentPage.md) - [`deleteGuidelineDocumentPageCategory`](../mutation/deleteGuidelineDocumentPageCategory.md) - [`deleteGuidelineDocumentPageLink`](../mutation/deleteGuidelineDocumentPageLink.md) - [`duplicateGuidelineDocumentPage`](../mutation/duplicateGuidelineDocumentPage.md) - [`hideGuidelineDocumentFromNavigation`](../mutation/hideGuidelineDocumentFromNavigation.md) - [`hideGuidelineDocumentGroupFromNavigation`](../mutation/hideGuidelineDocumentGroupFromNavigation.md) - [`hideGuidelineDocumentPageFromNavigation`](../mutation/hideGuidelineDocumentPageFromNavigation.md) - [`moveGuidelineDocumentPage`](../mutation/moveGuidelineDocumentPage.md) - [`publishGuidelineDocumentPage`](../mutation/publishGuidelineDocumentPage.md) - [`showGuidelineDocumentGroupInNavigation`](../mutation/showGuidelineDocumentGroupInNavigation.md) - [`showGuidelineDocumentInNavigation`](../mutation/showGuidelineDocumentInNavigation.md) - [`showGuidelineDocumentPageInNavigation`](../mutation/showGuidelineDocumentPageInNavigation.md) - [`unpublishGuidelineDocumentPage`](../mutation/unpublishGuidelineDocumentPage.md) - [`updateGuidelineDocument`](../mutation/updateGuidelineDocument.md) - [`updateGuidelineDocumentGroup`](../mutation/updateGuidelineDocumentGroup.md) - [`updateGuidelineDocumentLink`](../mutation/updateGuidelineDocumentLink.md) - [`updateGuidelineDocumentPage`](../mutation/updateGuidelineDocumentPage.md) - [`updateGuidelineDocumentPageCategory`](../mutation/updateGuidelineDocumentPageCategory.md) - [`updateGuidelineDocumentPageLink`](../mutation/updateGuidelineDocumentPageLink.md) ## Reach via Example queries that can return this type from the root `Query`. ### `assets` ```graphql query Assets { assets(ids: "…") { ... on Document { __typename alternativeText attachments { name filename id createdAt downloadUrl extension creator { __typename name id } modifier { __typename name id } } author availability { from to } comments { total page limit hasNextPage items { id content createdAt isResolved creator { id } currentUserPermissions { canDelete } } } copyright { notice status } createdAt creator { __typename name id } currentUserPermissions { canComment canDelete canDownload canEdit } customMetadata { __typename property { name id createdAt defaultValue creator { id } dependency { propertyId } } ... on CustomMetadataValue { value } ... on CustomMetadataValues { values } } description downloadUrl expiresAt extension externalId fileCreatedAt filename focalPoint height id isDecorative licenses { title id addByDefault license requireConsensus } location { brand { name id } folder { name id breadcrumbs { id } } library { name id } workspaceProject { name id } } modifiedAt modifier { __typename name id } pageCount previewBackgroundColor { alpha blue green red } previewUrl provenance { certExpiresAt certIssuedAt certIssuer certStatus certSubject contentOrigin } relatedAssets { 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 } } } revisions { total page limit hasNextPage items { id createdAt creator { id } } } size status tags { source value } targets { name id } thumbnailUrl title variants { total page limit hasNextPage items { filename downloadUrl key } } width workflowTask { title id description asset { __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 } } assignedUsers { __typename name id } checklistItem { total page limit hasNextPage items { id } } status { name id enterRules assignedUsers { id } checklistPresets { id } } } } } } ``` Raw: [`Assets-Document.sdl`](../examples/Assets-Document.sdl) ### `asset` ```graphql query Asset { asset(id: "…") { ... on Document { __typename alternativeText attachments { name filename id createdAt downloadUrl extension creator { __typename name id } modifier { __typename name id } } author availability { from to } comments { total page limit hasNextPage items { id content createdAt isResolved creator { id } currentUserPermissions { canDelete } } } copyright { notice status } createdAt creator { __typename name id } currentUserPermissions { canComment canDelete canDownload canEdit } customMetadata { __typename property { name id createdAt defaultValue creator { id } dependency { propertyId } } ... on CustomMetadataValue { value } ... on CustomMetadataValues { values } } description downloadUrl expiresAt extension externalId fileCreatedAt filename focalPoint height id isDecorative licenses { title id addByDefault license requireConsensus } location { brand { name id } folder { name id breadcrumbs { id } } library { name id } workspaceProject { name id } } modifiedAt modifier { __typename name id } pageCount previewBackgroundColor { alpha blue green red } previewUrl provenance { certExpiresAt certIssuedAt certIssuer certStatus certSubject contentOrigin } relatedAssets { 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 } } } revisions { total page limit hasNextPage items { id createdAt creator { id } } } size status tags { source value } targets { name id } thumbnailUrl title variants { total page limit hasNextPage items { filename downloadUrl key } } width workflowTask { title id description asset { __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 } } assignedUsers { __typename name id } checklistItem { total page limit hasNextPage items { id } } status { name id enterRules assignedUsers { id } checklistPresets { id } } } } } } ``` Raw: [`Asset-Document.sdl`](../examples/Asset-Document.sdl) ### `account › search` ```graphql query AccountSearch { account { search(limit: 25, page: 1) { items { ... on Document { __typename alternativeText attachments { name filename id createdAt downloadUrl extension creator { __typename name id } modifier { __typename name id } } author availability { from to } comments { total page limit hasNextPage items { id content createdAt isResolved creator { id } currentUserPermissions { canDelete } } } copyright { notice status } createdAt creator { __typename name id } currentUserPermissions { canComment canDelete canDownload canEdit } customMetadata { __typename property { name id createdAt defaultValue creator { id } dependency { propertyId } } ... on CustomMetadataValue { value } ... on CustomMetadataValues { values } } description downloadUrl expiresAt extension externalId fileCreatedAt filename focalPoint height id isDecorative licenses { title id addByDefault license requireConsensus } location { brand { name id } folder { name id breadcrumbs { id } } library { name id } workspaceProject { name id } } modifiedAt modifier { __typename name id } pageCount previewBackgroundColor { alpha blue green red } previewUrl provenance { certExpiresAt certIssuedAt certIssuer certStatus certSubject contentOrigin } relatedAssets { 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 } } } revisions { total page limit hasNextPage items { id createdAt creator { id } } } size status tags { source value } targets { name id } thumbnailUrl title variants { total page limit hasNextPage items { filename downloadUrl key } } width workflowTask { title id description asset { __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 } } assignedUsers { __typename name id } checklistItem { total page limit hasNextPage items { id } } status { name id enterRules assignedUsers { id } checklistPresets { id } } } } } } } } ``` Raw: [`AccountSearch-Document.sdl`](../examples/AccountSearch-Document.sdl) ### `assets › relatedAssets` ```graphql query AssetsRelatedAssets { assets(ids: "…") { relatedAssets(limit: 25, page: 1) { items { ... on Document { __typename alternativeText attachments { name filename id createdAt downloadUrl extension creator { __typename name id } modifier { __typename name id } } author availability { from to } comments { total page limit hasNextPage items { id content createdAt isResolved creator { id } currentUserPermissions { canDelete } } } copyright { notice status } createdAt creator { __typename name id } currentUserPermissions { canComment canDelete canDownload canEdit } customMetadata { __typename property { name id createdAt defaultValue creator { id } dependency { propertyId } } ... on CustomMetadataValue { value } ... on CustomMetadataValues { values } } description downloadUrl expiresAt extension externalId fileCreatedAt filename focalPoint height id isDecorative licenses { title id addByDefault license requireConsensus } location { brand { name id } folder { name id breadcrumbs { id } } library { name id } workspaceProject { name id } } modifiedAt modifier { __typename name id } pageCount previewBackgroundColor { alpha blue green red } previewUrl provenance { certExpiresAt certIssuedAt certIssuer certStatus certSubject contentOrigin } relatedAssets { 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 } } } revisions { total page limit hasNextPage items { id createdAt creator { id } } } size status tags { source value } targets { name id } thumbnailUrl title variants { total page limit hasNextPage items { filename downloadUrl key } } width workflowTask { title id description asset { __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 } } assignedUsers { __typename name id } checklistItem { total page limit hasNextPage items { id } } status { name id enterRules assignedUsers { id } checklistPresets { id } } } } } } } } ``` Raw: [`AssetsRelatedAssets-Document.sdl`](../examples/AssetsRelatedAssets-Document.sdl) ### `asset › relatedAssets` ```graphql query AssetRelatedAssets { asset(id: "…") { relatedAssets(limit: 25, page: 1) { items { ... on Document { __typename alternativeText attachments { name filename id createdAt downloadUrl extension creator { __typename name id } modifier { __typename name id } } author availability { from to } comments { total page limit hasNextPage items { id content createdAt isResolved creator { id } currentUserPermissions { canDelete } } } copyright { notice status } createdAt creator { __typename name id } currentUserPermissions { canComment canDelete canDownload canEdit } customMetadata { __typename property { name id createdAt defaultValue creator { id } dependency { propertyId } } ... on CustomMetadataValue { value } ... on CustomMetadataValues { values } } description downloadUrl expiresAt extension externalId fileCreatedAt filename focalPoint height id isDecorative licenses { title id addByDefault license requireConsensus } location { brand { name id } folder { name id breadcrumbs { id } } library { name id } workspaceProject { name id } } modifiedAt modifier { __typename name id } pageCount previewBackgroundColor { alpha blue green red } previewUrl provenance { certExpiresAt certIssuedAt certIssuer certStatus certSubject contentOrigin } relatedAssets { 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 } } } revisions { total page limit hasNextPage items { id createdAt creator { id } } } size status tags { source value } targets { name id } thumbnailUrl title variants { total page limit hasNextPage items { filename downloadUrl key } } width workflowTask { title id description asset { __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 } } assignedUsers { __typename name id } checklistItem { total page limit hasNextPage items { id } } status { name id enterRules assignedUsers { id } checklistPresets { id } } } } } } } } ``` Raw: [`AssetRelatedAssets-Document.sdl`](../examples/AssetRelatedAssets-Document.sdl) ### `brand › search` ```graphql query BrandSearch { brand(id: "…") { search(limit: 25, page: 1) { items { ... on Document { __typename alternativeText attachments { name filename id createdAt downloadUrl extension creator { __typename name id } modifier { __typename name id } } author availability { from to } comments { total page limit hasNextPage items { id content createdAt isResolved creator { id } currentUserPermissions { canDelete } } } copyright { notice status } createdAt creator { __typename name id } currentUserPermissions { canComment canDelete canDownload canEdit } customMetadata { __typename property { name id createdAt defaultValue creator { id } dependency { propertyId } } ... on CustomMetadataValue { value } ... on CustomMetadataValues { values } } description downloadUrl expiresAt extension externalId fileCreatedAt filename focalPoint height id isDecorative licenses { title id addByDefault license requireConsensus } location { brand { name id } folder { name id breadcrumbs { id } } library { name id } workspaceProject { name id } } modifiedAt modifier { __typename name id } pageCount previewBackgroundColor { alpha blue green red } previewUrl provenance { certExpiresAt certIssuedAt certIssuer certStatus certSubject contentOrigin } relatedAssets { 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 } } } revisions { total page limit hasNextPage items { id createdAt creator { id } } } size status tags { source value } targets { name id } thumbnailUrl title variants { total page limit hasNextPage items { filename downloadUrl key } } width workflowTask { title id description asset { __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 } } assignedUsers { __typename name id } checklistItem { total page limit hasNextPage items { id } } status { name id enterRules assignedUsers { id } checklistPresets { id } } } } } } } } ``` Raw: [`BrandSearch-Document.sdl`](../examples/BrandSearch-Document.sdl)