> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alumio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Storage: Save item

> Saves data to a storage with an identifier.

Saves data into a storage under an identifier you choose, so a later step or run can read it back. Use it to keep a value or a whole record around between steps, to build up a lookup table, or to remember something across runs. If an item with the same identifier already exists, it is overwritten. The data flowing through your transformation is passed along unchanged, so saving never alters the entity you are working with.

This documentation describes: [Schema](/schemas/transformer/storage-save-entity-in-storage)

## Fields

**Storage**

Required

The storage to write the item into. You select a storage that was set up beforehand.

See the [storage](/references/storage) reference.

**Storage entity identifier**

Required

The identifier the item is stored under. Reuse the same identifier later to read, update, or remove the item. [Placeholders](/references/placeholders) are supported, so you can build the identifier from the data, for example `&{sku}`. The value must be present and cannot be empty, otherwise the run stops with an error.

**Source**

Optional

The location of the part of your data you want to store. Leave it empty to store the entire entity. To store a single value or a nested section, point at it, for example `customer` or `customer.email`. [Placeholders](/references/placeholders) are supported.

## Sample data

This transformer writes to a configured storage backend and leaves your data unchanged, so there is no fixed before and after to show. The example below stores the whole entity under the identifier taken from its `sku` field. With Source set to `name`, only that single value would be stored under the same identifier instead.

| Field | Value |
| - | - |
| Storage | A storage set up beforehand |
| Storage entity identifier | `&{sku}` |
| Source | (empty, stores the whole entity) |

```json Configuration theme={null}
{
  "prototype": "storage-save-entity-in-storage",
  "parameters": {
    "storage": { "prototype": "storage", "parameters": {} },
    "storageKey": "&{sku}"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.