---
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: 350
product: Flux
version: v0
publisher: InfluxData
canonical: https://docs.influxdata.com/flux/v0/stdlib/dict/insert/
date: '2024-04-08T16:01:02-06:00'
lastmod: '2024-04-08T16:01:02-06:00'
---

* Flux 0.97.0+

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

```
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

```
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/)