---
title: "Asset Collection"
description: "Asset Collection"
url: "https://www.contentstack.com/docs/developers/sdks/content-delivery-sdk/typescript/reference/asset-collection"
product: "Contentstack"
doc_type: "guide"
audience:
  - developers
  - admins
version: "current"
last_updated: "2026-09-08"
---

# Asset Collection

## Asset Collection

The Asset Collection provides methods for filtering and retrieving assets stored in Contentstack. You can retrieve specific assets by UID, tags, or metadata.

**Example:**

```
const result = stack.asset().find<BlogAsset>()
  .then((assets) => console.log(assets))
  .catch((error) => console.error("Error fetching assets:", error));
```

## addParams

The addParam method adds a query parameter to the query.

```
Example:
import { BaseAsset, FindAsset } from '@contentstack/delivery-sdk'

interface BlogAsset extends BaseAsset {
  // other custom props
  dimension: {
    height: string;
    width: string;
  };
}

const asset = await stack
                      .asset()
                      .addParams({"key": "value"})
                      .find<BlogAsset>();
```

Add key-value pairs

## find

The find method retrieves all the assets of the stack.

```
Example:
const result = await stack.asset().find<BlogAsset>();
```

## includeBranch

The includeBranch method includes the branch details in the result.

```
Example:
const result = await stack.asset().includeBranch().find<BlogAsset>();
```

## includeCount

The includeCount method retrieves count and data of all the objects in the result.

```
Example:
const asset = await stack.asset().includeCount().find<BlogAsset>();
```

## includeDimension

The includeDimension method includes the dimensions (height and width) of the image in the result

```
Example:
const result = await stack.asset().includeDimension().find<BlogAsset>();
```

## includeFallback

The includeFallback method retrieves the entry in its fallback language.

```
Example:
const result = await stack.asset().includeFallback().find<BlogAsset>();
```

## locale

The locale method retrieves the asset published in the specified locale.

```
Example:
const result = await stack.asset().locale('en-us').find<BlogAsset>();
```

Locale of the asset

## orderByAscending

The orderByAscending method sorts the results in ascending order based on the specified field UID.

```
Example:
const asset = await stack.asset().orderByAscending().find<BlogAsset>();
```

Field UID to sort the results

## orderByDescending

The orderByDescending method sorts the results in descending order based on the specified key.

```
Example:
const asset = await stack.asset().orderByDescending().find<BlogAsset>();
```

Field UID to sort the results

## param

The param method adds query parameters to the URL.

```
Example:
const asset = await stack.asset().param("key", "value").find<BlogAsset>();
```

Add any param to include in the response

Add the corresponding value of the param key

## relativeUrls

The relativeUrls method includes the relative URLs of all the assets in the result.

```
Example:
const result = await stack.asset().relativeUrls().find<BlogAsset>();
```

## removeParam

The removeParam method removes a query parameter from the query.

```
Example:
const asset = await stack.asset().removeParam("query_param_key").find<BlogAsset>();
```

Specify the param key you want to remove

## version

The version method retrieves a specific version of the asset in the result.

```
Example:
const result = await stack.asset().version(1).find<BlogAsset>();
```

Version number of the asset

## where

The where method filters the results based on the specified criteria.

```
Example:
const result = await stack.asset().query().where("field_UID", QueryOperation.IS_LESS_THAN, ["field1", "field2"])

.find<BlogAsset>();
```

Specify the field the comparison is made from

Specify the comparison criteria

Specify the field the comparison is made to

## includeMetadata

The includeMetadata method includes the metadata for getting metadata content for the entry.

```
Example:
const result = await stack.asset().includeMetadata().find<BlogAsset>();
```

## skip

The skip method will skip a specific number of assets in the output.

```
Example:
const result = await stack.asset().skip(5).find<BlogAsset>();
```

Enter the number of assets to be skipped.

## limit

The limit method will return a specific number of assets in the output.

```
Example:
const result = await stack.asset().limit(5).find<BlogAsset>();
```

Enter the maximum number of assets to be returned.

## Asset Collection | TypeScript Delivery SDK | Contentstack

Asset Collection in the TypeScript Delivery SDK filters and retrieves assets stored in Contentstack by UID, tags, or metadata.