---

title: "JSON" lang: "en-US" draft: false description: "Learn about how to set up a VDP JSON operator https://github.com/instill-ai/vdp"

The JSON component is an operator that allows users to manipulate and convert JSON objects. It can carry out the following tasks:

• Marshal
• Unmarshal
• jq

Release Stage

Alpha

Configuration

The component configuration is defined and maintained here.

Supported Tasks

Marshal

Convert JSON to a string

Input	ID	Type	Description
Task ID (required)	task	string	TASK_MARSHAL
JSON (required)	json	any	JSON input to be marshaled

Output	ID	Type	Description
JSON string	string	string	String representation of the JSON input

Unmarshal

Convert a string to JSON

Input	ID	Type	Description
Task ID (required)	task	string	TASK_UNMARSHAL
String (required)	string	string	JSON string to be unmarshaled

Output	ID	Type	Description
JSON	json	any	JSON object extracted from the string input

jq

Process JSON through a jq command

Input	ID	Type	Description
Task ID (required)	task	string	TASK_JQ
JSON input (required)	jsonInput	string	JSON string to be processed
Filter (required)	jqFilter	string	Filter, in jq syntax, that will be applied to the JSON input

Output	ID	Type	Description
Results	results	array	The jq command results. Depending on the filter and the input JSON the type of each element may vary.