---
modificationDate: October 06, 2025
title: Asset selection and exclusion
description: Learn how to use the asset selection feature and verify that an update includes all required app assets.
---

<AgentInstructions>

## Submitting Feedback

If this page contains errors, outdated information, or gaps that blocked you from completing a task, report it so the docs can be improved:

curl -X POST https://api.expo.dev/v2/feedback/docs-send -H 'Content-Type: application/json' -d '{"url":"/eas-update/asset-selection/","feedback":"🤖 Agent feedback: <specific, actionable description>"}'

Only submit when you have something specific and actionable to report.

</AgentInstructions>

# Asset selection and exclusion

Learn how to use the asset selection feature and verify that an update includes all required app assets.

> For the complete documentation index, see [llms.txt](/llms.txt). Use this file to discover all available pages.

Experimental **asset selection feature** allows the developer to specify that only certain assets should be included in updates. This can greatly reduce the number of assets that need to be uploaded to and downloaded from the updates server. This feature will work with the EAS Update server or any custom server that complies with the [`expo-updates` protocol](/technical-specs/expo-updates-1).

SDK 52 launched this feature to general availability.

## Using asset selection

To use asset selection in SDK versions below 52, include the property `extra.updates.assetPatternsToBeBundled` in your app config. It should define one or more file-matching patterns (regular expressions). For example, an **app.json** file has the patterns defined in the following way:

```json
"expo": {
    ... 
    "extra": {
      "updates": {
        "assetPatternsToBeBundled": [
          "app/images/**/*.png"
        ]
      }
    }
  }
```

To use asset selection in SDK 52 and later, include the property `updates.assetPatternsToBeBundled` in your app config. It should define one or more file-matching patterns (regular expressions). For example, an **app.json** file has the patterns defined in the following way:

```json
"expo": {
    ... 
    "updates": {
      "assetPatternsToBeBundled": [
        "app/images/**/*.png"
      ]
    }
  }
```

After adding this configuration all **.png** files in all subdirectories of **app/images** will be included in updates. You have to also ensure that these assets need to be required in your JavaScript code.

If `assetPatternsToBeBundled` isn't included in the app config, all assets resolved by the bundler will be included in updates (as per SDK 49 and earlier behavior).

## Verifying that an update includes all required app assets

When using the asset selection, assets that do not match any file patterns will resolve in the Metro bundler. However, these assets will not be uploaded to the updates server. You have to be certain that assets not included in updates are built into the native build of the app.

If you are building your app locally or have access to the correct build for publishing updates (with the same [runtime version](/eas-update/runtime-versions)), then use the `npx expo-updates assets:verify` command. It allows you to check whether all required assets will be included when you publish an update:

```sh
npx expo-updates assets:verify
```

> This new command is part of the `expo-updates` CLI, which also supports [EAS Update code signing](/eas-update/code-signing). It is not part of the [Expo CLI](/more/expo-cli) or the [EAS CLI](https://github.com/expo/eas-cli). Only available for ([`expo-updates`](/versions/latest/sdk/updates) >= 0.24.10).

You can also use the `--help` option with the command to see the available options:

| Option | Description |
| --- | --- |
| `<dir>` | Directory of the Expo project. Default: Current working directory. |
| `-a, --asset-map-path <path>` | Path to the **assetmap.json** in an export produced by the command `npx expo export --dump-assetmap` . |
| `-e, --exported-manifest-path <path>` | Path to the **metadata.json** in an export produced by the command `npx expo export --dump-assetmap`. |
| `-b, --build-manifest-path <path>` | Path to the **app.manifest** file created by `expo-updates` in an Expo application build (either **android** or **ios**). |
| `-p, --platform <platform>` | Options: ["android", "ios"] |
| `-h, --help` | Usage info. |

## Example

[Working example](https://github.com/expo/UpdatesAPIDemo) — See a working example of using asset selection, the assets:verify command, and other EAS Update features. — assets:verify