---
title: dict.insert() function
description: dict.insert() inserts a key-value pair into a dictionary and returns a new, updated dictionary.
url: https://docs.influxdata.com/flux/v0/stdlib/dict/insert/
estimated_tokens: 1245
product: Flux
version: v0
---

# dict.insert() function

-   Flux 0.97.0+
-   View InfluxDB support

`dict.insert()` inserts a key-value pair into a dictionary and returns a new, updated dictionary.

If the key already exists in the dictionary, the function overwrites the existing value.

##### Function type signature

```js
(dict: [A:B], key: A, value: B) => [A:B] where A: Comparable
```

For more information, see [Function type signatures](/flux/v0/function-type-signatures/).

## Parameters

### dict

(Required) Dictionary to update.

### key

(Required) Key to insert into the dictionary. Must be the same type as the existing keys in the dictionary.

### value

(Required) Value to insert into the dictionary. Must be the same type as the existing values in the dictionary.

## Examples

-   [Insert a new key-value pair into the a dictionary](#insert-a-new-key-value-pair-into-the-a-dictionary)
-   [Overwrite an existing key-value pair in a dictionary](#overwrite-an-existing-key-value-pair-in-a-dictionary)

### Insert a new key-value pair into the a dictionary

```js
import "dict"

d = [1: "foo", 2: "bar"]

dict.insert(dict: d, key: 3, value: "baz")// Returns [1: "foo", 2: "bar", 3: "baz"]

```

### Overwrite an existing key-value pair in a dictionary

```js
import "dict"

d = [1: "foo", 2: "bar"]

dict.insert(dict: d, key: 2, value: "baz")// Returns [1: "foo", 2: "baz"]

```

#### Related

-   [Work with dictionaries](/flux/v0/data-types/composite/dict/)