# loadData

[Built-ins](README.md)

Canonical ID: `storage.get`. Nederlands: `laadGegeven`.

Loads a fresh copy of a saved value, or a fresh copy of the fallback when the key is absent. The fallback must be [JSON-compatible](../concepts/json.md) too. Updating a returned collection does not write it back: call saveData explicitly to persist changes. None can be a saved value, so it is not automatically treated as a missing key.

## Signature

```text
loadData(key, fallback)
```

## Arguments

| Parameter | Type | Requirement |
|---|---|---|
| `key` | Text | Nonempty, no surrounding whitespace/control characters, at most 128 [UTF-8](../concepts/utf-8.md) bytes. |
| `fallback` | JSON-compatible | Returned as a fresh copy when the key is absent. |

## Return value

saved value or fallback.

## Example

```pliro
# language: en
deleteData("new-score")
let fallback = [0]
let score = loadData("new-score", fallback)
set score[0] = 7
say fallback[0]
```

Prints `0`; the fallback is copied.

## Notes and common mistakes

Use the function name for your source language. Its [canonical ID](../concepts/canonical-identity.md) is a shared documentation label; you do not type that ID as a call. Giving your own variable or function the same name can hide the built-in. Supply the documented [arguments](../concepts/parameters-and-arguments.md) and value types. Pliro reports mismatches when checking can detect them, or when the call runs.

Keys and saved text are not translated. Limits are 128 keys, 64 KiB per JSON value, 512 KiB per document, 32 nesting levels, and 8,192 values/nodes per value. Functions, nonfinite numbers, and Maps with non-Text keys cannot be stored. A usable portable project identity enables durable data; loose source uses temporary session storage. See the storage guide for E4014–E4017 and copy/identity rules.

## Related entries

[saveData](saveData.md) · [deleteData](deleteData.md) · [savedDataKeys](savedDataKeys.md) · [Programming guides](../guides/storage.md) · [Host support](../guides/hosts.md) · [Calls and arguments](../syntax/calls.md)