# @aws-sdk/util-dynamodb

> [![NPM version](https://img.shields.io/npm/v/@aws-sdk/util-dynamodb/latest.svg)](https://www.npmjs.com/package/@aws-sdk/util-dynamodb) [![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/util-dynamodb.svg)](https://www.npmjs.com/package/@aws-sdk/util

Latest version **3.996.9** (published 2026-08-14) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @aws-sdk/util-dynamodb
pnpm add @aws-sdk/util-dynamodb
yarn add @aws-sdk/util-dynamodb
bun add @aws-sdk/util-dynamodb
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 3.996.9 |
| Published | 2026-08-14 |
| First published | 2020-09-29 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=20.0.0 |
| Dependencies | 1 |
| Unpacked size | 51.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 3670 |
| Author | AWS SDK for JavaScript Team |
| Maintainers | amzn-oss, aws-sdk-bot |

## Links

- npm: https://www.npmjs.com/package/@aws-sdk/util-dynamodb
- Repository: https://github.com/aws/aws-sdk-js-v3
- Homepage: https://github.com/aws/aws-sdk-js-v3/tree/main/packages/util-dynamodb
- Issues: https://github.com/aws/aws-sdk-js-v3/issues
- npm.io page: https://npm.io/package/@aws-sdk/util-dynamodb

## Dependencies (1)

- [tslib](https://npm.io/package/tslib.md) ^2.6.2

## Recent versions

- 3.996.9 (latest) — 2026-08-14
- 3.5.1-rc.0 (rc) — 2021-02-19
- 1.0.0-gamma.2 (gamma) — 2020-10-07
- 3.996.8 — 2026-08-11
- 3.996.7 — 2026-07-15
- 3.996.6 — 2026-07-08
- 3.996.5 — 2026-06-15
- 3.996.4 — 2026-06-08
- 3.996.3 — 2026-06-05
- 3.996.2 — 2026-03-05
- 3.996.1 — 2026-02-24
- 3.996.0 — 2026-02-23
- 3.995.0 — 2026-02-20
- 3.994.0 — 2026-02-19
- 3.993.0 — 2026-02-18
- … 553 more at https://npm.io/package/@aws-sdk/util-dynamodb/versions

## README

# @aws-sdk/util-dynamodb

[![NPM version](https://img.shields.io/npm/v/@aws-sdk/util-dynamodb/latest.svg)](https://www.npmjs.com/package/@aws-sdk/util-dynamodb)
[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/util-dynamodb.svg)](https://www.npmjs.com/package/@aws-sdk/util-dynamodb)

This package provides utilities to be used with `@aws-sdk/client-dynamodb`

If you are looking for DynamoDB Document client, please check
[@aws-sdk/lib-dynamodb](https://www.npmjs.com/package/@aws-sdk/lib-dynamodb)
which automatically performs the necessary marshalling and unmarshalling.

## Convert JavaScript object into DynamoDB Record

```js
const { DynamoDB } = require("@aws-sdk/client-dynamodb");
const { marshall } = require("@aws-sdk/util-dynamodb");

const client = new DynamoDB(clientParams);
const params = {
  TableName: "Table",
  Item: marshall({
    HashKey: "hashKey",
    NumAttribute: 1,
    BoolAttribute: true,
    ListAttribute: [1, "two", false],
    MapAttribute: { foo: "bar" },
    NullAttribute: null,
  }),
};

await client.putItem(params);
```

## Convert DynamoDB Record into JavaScript object

```js
const { DynamoDB } = require("@aws-sdk/client-dynamodb");
const { marshall, unmarshall } = require("@aws-sdk/util-dynamodb");

const client = new DynamoDB(clientParams);
const params = {
  TableName: "Table",
  Key: marshall({
    HashKey: "hashKey",
  }),
};

const { Item } = await client.getItem(params);
unmarshall(Item);
```

---
_Source: https://npm.io/package/@aws-sdk/util-dynamodb · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._