# TableV2MultiAccountReplicaProps

Properties for creating a multi-account replica table.

Note: partitionKey, sortKey, and localSecondaryIndexes are not options because CloudFormation
automatically inherits the key schema and LSIs from the source table via globalTableSourceArn.

Extends: TableV2MultiAccountReplicaProps
Extends: TableOptionsV2
Used as props by: TableV2MultiAccountReplica

- Source: [`aws-dynamodb/lib/table-v2.ts`](https://github.com/aws/aws-cdk/blob/v2.274.0/packages/aws-cdk-lib/aws-dynamodb/lib/table-v2.ts#L472)
- Type last changed: v2.239.0 · 19 Feb 2026

## Example

```ts
import * as cdk from 'aws-cdk-lib';

const app = new cdk.App();

// Source table in Account A
const sourceStack = new cdk.Stack(app, 'SourceStack', {
  env: { region: 'us-east-2', account: '111111111111' },
});

const sourceTable = new dynamodb.TableV2(sourceStack, 'SourceTable', {
  tableName: 'MyMultiAccountTable',
  partitionKey: { name: 'pk', type: dynamodb.AttributeType.STRING },
  globalTableSettingsReplicationMode: dynamodb.GlobalTableSettingsReplicationMode.ALL,
});

// Replica stack in Account B
const replicaStack = new cdk.Stack(app, 'ReplicaStack', {
  env: { region: 'us-east-1', account: '222222222222' },
});

// Create replica - permissions are automatically configured
const replica = new dynamodb.TableV2MultiAccountReplica(replicaStack, 'ReplicaTable', {
  tableName: 'MyMultiAccountTable',
  replicaSourceTable: sourceTable,
  globalTableSettingsReplicationMode: dynamodb.GlobalTableSettingsReplicationMode.ALL,
});
```

## Properties

- `contributorInsights`: boolean = false — use `contributorInsightsSpecification` instead

- `contributorInsightsSpecification`: [ContributorInsightsSpecification](/cdk/api/v2/docs/aws-cdk-lib.aws_dynamodb.ContributorInsightsSpecification.html) — Whether CloudWatch contributor insights is enabled and what mode is selected.

  **Default:** contributor insights is not enabled

- `deletionProtection`: boolean = false — Whether deletion protection is enabled.

- `encryption`: [TableEncryptionV2](/cdk/api/v2/docs/aws-cdk-lib.aws_dynamodb.TableEncryptionV2.html) — The server-side encryption configuration for the replica table.

  **Default:** TableEncryptionV2.dynamoOwnedKey()

  Note: Each replica manages its own encryption independently. This is not synchronized
  across replicas.

- `globalTableSettingsReplicationMode`: [GlobalTableSettingsReplicationMode](/cdk/api/v2/docs/aws-cdk-lib.aws_dynamodb.GlobalTableSettingsReplicationMode.html) — Controls whether table settings are synchronized across replicas.

  **Default:** GlobalTableSettingsReplicationMode.ALL

  When set to ALL, synchronizable settings (billing mode, throughput, TTL, streams view type, GSIs)
  are automatically replicated across all replicas. When set to NONE, each replica manages its own
  settings independently (billing mode must be PAY_PER_REQUEST).

  Note: Some settings are always synchronized (key schema, LSIs) regardless of this setting,
  and some are never synchronized (table class, SSE, deletion protection, PITR, tags, resource policy).

- `grantIndexPermissions`: boolean = false — Whether or not to grant permissions for all indexes of the table.

  Note: If false, permissions will only be granted to indexes when `globalIndexes` is specified.

- `kinesisStream`: [IStream](/cdk/api/v2/docs/aws-cdk-lib.aws_kinesis.IStream.html) — Kinesis Data Stream to capture item level changes.

  **Default:** no Kinesis Data Stream

- `pointInTimeRecovery`: boolean — use `pointInTimeRecoverySpecification` instead

  **Default:** false - point in time recovery is not enabled.

- `pointInTimeRecoverySpecification`: [PointInTimeRecoverySpecification](/cdk/api/v2/docs/aws-cdk-lib.aws_dynamodb.PointInTimeRecoverySpecification.html) — Whether point-in-time recovery is enabled and recoveryPeriodInDays is set.

  **Default:** point in time recovery is not enabled.

- `removalPolicy`: [RemovalPolicy](/cdk/api/v2/docs/aws-cdk-lib.RemovalPolicy.html) = RemovalPolicy.RETAIN — The removal policy applied to the table.

- `replicaSourceTable`: [ITableV2](/cdk/api/v2/docs/aws-cdk-lib.aws_dynamodb.ITableV2.html) — The source table to replicate from.

  **Default:** must be provided

  [disable-awslint:prefer-ref-interface]

- `resourcePolicy`: [PolicyDocument](/cdk/api/v2/docs/aws-cdk-lib.aws_iam.PolicyDocument.html) — Resource policy to assign to DynamoDB Table.

  **Default:** No resource policy statements are added to the created table.

- `streamResourcePolicy`: [PolicyDocument](/cdk/api/v2/docs/aws-cdk-lib.aws_iam.PolicyDocument.html) — Resource policy to assign to DynamoDB Stream.

  **Default:** No resource policy statements are added to the stream.

- `tableClass`: [TableClass](/cdk/api/v2/docs/aws-cdk-lib.aws_dynamodb.TableClass.html) = TableClass.STANDARD — The table class.

- `tableName`: string — Enforces a particular physical table name.

  **Default:** generated by CloudFormation

- `tags`: [CfnTag](/cdk/api/v2/docs/aws-cdk-lib.CfnTag.html)[] — Tags to be applied to the primary table (default replica table).

  **Default:** no tags