---
title: "encoding | Grafana Cloud documentation"
description: "Learn about encoding functions"
---

# encoding

The `encoding` namespace contains encoding and decoding functions.

## encoding.from\_base64

The `encoding.from_base64` function decodes a RFC4648-compliant Base64-encoded string into the original string.

`encoding.from_base64` fails if the provided string argument contains invalid Base64 data.

### Example

text ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```text
> encoding.from_base64("dGFuZ2VyaW5l")
tangerine
```

## encoding.from\_URLbase64

The `encoding.from_URLbase64` function decodes a RFC4648-compliant Base64 URL safe encoded string into the original string.

`encoding.from_URLbase64` fails if the provided string argument contains invalid Base64 data.

### Example

![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```none
> encoding.from_URLbase64("c3RyaW5nMTIzIT8kKiYoKSctPUB-")
string123!?$*&()'-=@~
```

## encoding.to\_base64

The `encoding.to_base64` function encodes the original string into RFC4648-compliant Base64 encoded string.

### Example

![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```none
> encoding.to_base64("string123!?$*&()'-=@~")
c3RyaW5nMTIzIT8kKiYoKSctPUB+
```

## encoding.to\_URLbase64

The `encoding.to_base64` function encodes the original string into RFC4648-compliant URL safe Base64 encoded string.

### Example

![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```none
> encoding.to_URLbase64("string123!?$*&()'-=@~")
c3RyaW5nMTIzIT8kKiYoKSctPUB-
```

## encoding.url\_encode

The `encoding.url_encode` function encodes the original string into a RFC3986 “percent encoding” compliant string.

### Example

![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```none
> encoding.url_encode("string123!?$*&()'-=@~")
string123%21%3F%24%2A%26%28%29%27-%3D%40~
```

## encoding.url\_decode

The `encoding.url_decode` function decodes a RFC3986 “percent encoding” compliant string. `encoding.url_decode` fails if input string is not RFC3986 “percent encoding” compliant.

### Example

![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```none
> encoding.url_decode("string123%21%3F%24%2A%26%28%29%27-%3D%40~")
string123!?$*&()'-=@~
```

## encoding.to\_json

The `encoding.to_json` function encodes the map into a JSON string. `encoding.to_json` fails if the input argument provided can’t be parsed as a JSON string.

A common use case for `encoding.to_json` is to encode a configuration of component which is expected to be a JSON string. For example, `config` argument of [`prometheus.exporter.blackbox`](/docs/grafana-cloud/send-data/alloy/reference/components/prometheus/prometheus.exporter.blackbox).

### Examples

Alloy ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```alloy
> encoding.to_json({"modules"={"http_2xx"={"prober"="http","timeout"="5s","http"={"headers"={"Authorization"=sys.env("TEST_VAR")}}}}})
"{\"modules\":{\"http_2xx\":{\"http\":{\"headers\":{\"Authorization\":\"Hello!\"}},\"prober\":\"http\",\"timeout\":\"5s\"}}}"
```

## encoding.from\_json

The `encoding.from_json` function decodes a string representing JSON into an Alloy value. `encoding.from_json` fails if the string argument provided can’t be parsed as JSON.

A common use case of `encoding.from_json` is to decode the output of a [`local.file`](/docs/grafana-cloud/send-data/alloy/reference/components/local/local.file) component to an Alloy value.

> Note
> 
> Remember to escape double quotes when passing JSON string literals to `encoding.from_json`.
> 
> For example, the JSON value `{"key": "value"}` is properly represented by the string `"{\"key\": \"value\"}"`.

### Examples

Alloy ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```alloy
> encoding.from_json("15")
15

> encoding.from_json("[1, 2, 3]")
[1, 2, 3]

> encoding.from_json("null")
null

> encoding.from_json("{\"key\": \"value\"}")
{
  key = "value",
}

> encoding.from_json(local.file.some_file.content)
"Hello, world!"
```

## encoding.from\_yaml

The `encoding.from_yaml` function decodes a string representing YAML into an Alloy value. `encoding.from_yaml` fails if the string argument provided can’t be parsed as YAML.

A common use case of `encoding.from_yaml` is to decode the output of a [`local.file`](/docs/grafana-cloud/send-data/alloy/reference/components/local/local.file) component to an Alloy value.

> Note
> 
> Remember to escape double quotes when passing YAML string literals to `encoding.from_yaml`.
> 
> For example, the YAML value `key: "value"` is properly represented by the string `"key: \"value\""`.

### Examples

Alloy ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```alloy
> encoding.from_yaml("15")
15
> encoding.from_yaml("[1, 2, 3]")
[1, 2, 3]
> encoding.from_yaml("null")
null
> encoding.from_yaml("key: value")
{
  key = "value",
}
> encoding.from_yaml(local.file.some_file.content)
"Hello, world!"
```