---
editLink: false
lastUpdated: false
---

[@salesforce/b2c-tooling-sdk](../../../modules.md) / [operations/code](../index.md) / findAndDeployCartridges

# Function: findAndDeployCartridges()

> **findAndDeployCartridges**(`instance`, `directory`, `options`): `Promise`\<[`DeployResult`](../interfaces/DeployResult.md)\>

Defined in: [packages/b2c-tooling-sdk/src/operations/code/deploy.ts:272](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/e7c16f1ae423da0aa47b3e10be88f9770b53619b/packages/b2c-tooling-sdk/src/operations/code/deploy.ts#L272)

Finds and deploys cartridges from a directory to an instance.

This is a high-level function that orchestrates the deployment process:
1. Finds cartridges in the specified directory (by .project files)
2. Applies include/exclude filters
3. Optionally deletes existing cartridges first
4. Creates a zip archive and uploads via WebDAV
5. Optionally reloads the code version

Requires `instance.config.codeVersion` to be set.

## Parameters

### instance

[`B2CInstance`](../../../instance/classes/B2CInstance.md)

B2C instance to deploy to (must have codeVersion set)

### directory

`string`

Directory to search for cartridges

### options

[`DeployOptions`](../interfaces/DeployOptions.md) = `{}`

Deploy options (filters, reload, delete)

## Returns

`Promise`\<[`DeployResult`](../interfaces/DeployResult.md)\>

Deploy result with cartridges and status

## Throws

Error if code version not set, no cartridges found, or deployment fails

## Example

```typescript
// Simple deploy
const result = await findAndDeployCartridges(instance, './cartridges');

// Deploy specific cartridges with reload
const result = await findAndDeployCartridges(instance, '.', {
  include: ['app_storefront_base'],
  reload: true,
});

// Delete existing cartridges before upload
const result = await findAndDeployCartridges(instance, './cartridges', {
  delete: true,
  reload: true,
});
```