# IStackSynthesizer

Encodes information how a certain Stack should be deployed.

Extends: IStackSynthesizer
Implemented by: AppStagingSynthesizer, BootstraplessSynthesizer, CliCredentialsStackSynthesizer, DefaultStackSynthesizer, LegacyStackSynthesizer, NestedStackSynthesizer, StackSynthesizer

- Source: [`core/lib/stack-synthesizers/types.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/core/lib/stack-synthesizers/types.ts#L8)
- Type last changed: v2.253.0 · 6 May 2026

## Properties

- `bootstrapQualifier`: string — The qualifier used to bootstrap this stack.

  **Default:** no qualifier

- `cloudFormationExecutionRole`: string — The role that is passed to CloudFormation to execute the change set.

  **Default:** no role

- `lookupRole`: string — The role used to lookup for this stack.

  **Default:** no role

## Methods

- `addDockerImageAsset(asset: DockerImageAssetSource): DockerImageAssetLocation` — Register a Docker Image Asset.

  Returns the parameters that can be used to refer to the asset inside the template.

- `addFileAsset(asset: FileAssetSource): FileAssetLocation` — Register a File Asset.

  Returns the parameters that can be used to refer to the asset inside the template.

- `bind(stack: Stack): void` — Bind to the stack this environment is going to be used on.

  Must be called before any of the other methods are called, and can only be called once.

- `synthesize(session: ISynthesisSession): void` — Synthesize the associated stack to the session.