---
title: "parse · RUAL Documentation"
description: "Converts a JSON in text format to a data structure that can be used inside functions."
canonical: https://docs.rual.nl/block-types/value/value_json_parse
language: en
---

# parse

This block is part of the [`value`](https://docs.rual.nl/block-types/value) group and was last modified in core [`v10.4.28`](https://docs.rual.nl/core-versions/100428).

### Type Selection Required

This block requires you to select the data type you want to work with. You must manually select the type using the type selector modal. To access the modal, click the white button on the block.

### Field Selection Required

This block requires field selection (out). You must manually select the fields you want to work with using the field selector modal. To access the modal, click the white button on the block.

Converts a JSON in text format to a data structure that can be used inside functions.

- Stringified required `value`

- success `condition` Returns true if the value was parsed succesfully.

- error `value` Error that says why the block failed (only if success is false).

Parses JSON text and emits the result on the type-selected output pin; an unwired stringified pin parses the default "{}". The parsed value is NOT validated against the selected pin type. On parse failure success is false, error carries the parser message, and the selected pin receives an EMPTY OBJECT regardless of the chosen type.

| `json parse` |
| --- |
| `parse json` |

A typical wiring for [parse](https://docs.rual.nl/block-types/value/value_json_parse): [get cache key](https://docs.rual.nl/block-types/redis/function_redis_cache_get_exists) feeds the `stringified` pin; the `error` out pin feeds [reply in JSON](https://docs.rual.nl/block-types/json/httpconnection_set_json); the `success` out pin feeds [set custom field](https://docs.rual.nl/block-types/mutations/mutations_set_custom_field).

![Studio canvas example for the parse block: typical wiring for parse.](https://docs.rual.nl/canvas-examples/value_json_parse.png)

### Commonly used with

In production blueprints, this block is most often wired together with:

- [get cache key](https://docs.rual.nl/block-types/redis/function_redis_cache_get_exists): feeds into this block. gets the key and returns true or false based of its existence, makes it easier for cache-management in flows.

- [reply in JSON](https://docs.rual.nl/block-types/json/httpconnection_set_json): this block feeds into it. Reply to any httpconnection as JSON body.

- [return](https://docs.rual.nl/block-types/function%20execution/function_return): this block feeds into it. Returns the added custom pins as data-pins on the function execute.

- [Request: GET](https://docs.rual.nl/block-types/webhooks/function_trigger_webhook_http_get): feeds into this block. Performs an HTTP GET request to retrieve data from the specified URL. Returns the response as a string value.

- [set custom field](https://docs.rual.nl/block-types/mutations/mutations_set_custom_field): this block feeds into it.

- [value](https://docs.rual.nl/block-types/value/value_default): feeds into this block. Simply returns the provided value.

### Version history

Introduced in [`v10.4.28`](https://docs.rual.nl/core-versions/100428).