# What is the Structured Output Parser in n8n?

> The Structured Output Parser is an n8n sub-node that makes an AI chain or agent return JSON in a fixed shape, from an example or a JSON Schema.

Source: https://learn.ynteractive.com/content/glossary/structured-output-parser · Updated 2026-10-20 · Free from Stepthrough (https://learn.ynteractive.com)

[AI agents](https://learn.ynteractive.com/content/glossary#topic-ai-agents) · [AI glossary](https://learn.ynteractive.com/content/glossary)

Quick answer

The Structured Output Parser is an n8n sub-node you attach to an AI step, such as a Basic LLM Chain or an AI Agent with Require Specific Output Format turned on. You give it a JSON example or a JSON Schema, and it turns the model's answer into JSON with exactly those fields, so later nodes can map them reliably.

Last updated October 20, 2026

[Take the free module →](https://learn.ynteractive.com/courses/ai-for-operations/12)Module 12 of the free [AI for Operations Teams](https://learn.ynteractive.com/courses/ai-for-operations) course, about 15 minutes. No account needed.

Updated October 20, 2026 · By [Robert Breen](https://learn.ynteractive.com/content/about)

## Why it matters for a small business

AI models answer in prose by default, and prose is hard to put in a spreadsheet. Even when you ask for JSON, the wording or field names can drift between runs. The parser fixes the shape, so every run returns, say, vendor, date and total, in that form, and the Google Sheets step never meets a surprise.

It also fails loudly. If the model's answer does not fit the shape, the parser raises an error instead of passing on half-right data, which your [error handling](https://learn.ynteractive.com/content/glossary/error-handling) can catch. That is much better than a wrong total quietly landing in the books.

Where you'll use it: on an AI Agent node, turn on **Require Specific Output Format**, then click the output parser connector and add **Structured Output Parser**. Choose **Generate From JSON Example** and paste a sample, or **Define using JSON Schema**. The node's output then shows your fields under output.

## In a real lesson: n8n: Turn Meeting Notes into Action Items in a Google Sheet

In the free [n8n Meeting Notes to Action Items lesson](https://learn.ynteractive.com/content/meeting-notes-to-action-items-google-sheets-ai-n8n), Meridian Accounting Group gets fixed-shape answers a simpler way: the OpenAI node's prompt asks for a list called tasks, each with task, owner and due, and you set the response format to **JSON Object**.

The Structured Output Parser is the next step up when you use an AI Agent or chain instead. With a JSON example of one tasks list attached, every answer is checked against that shape before the Split Out node turns it into rows.

[Try this lesson free](https://learn.ynteractive.com/modules/n8n-meeting-notes-tasks) or [read the step-by-step guide](https://learn.ynteractive.com/content/meeting-notes-to-action-items-google-sheets-ai-n8n).

## Common confusions

### Parser vs JSON mode

JSON mode asks the model to return valid JSON. The parser also checks the JSON has the exact fields you need.

### Parser vs structured output

[Structured output](https://learn.ynteractive.com/content/glossary/structured-output) is the idea. The parser is n8n's node for getting it from chains and agents.

## Tips

- Keep the example small and use realistic values.
- Describe each field in the prompt as well, so the model knows what goes where.
- Test with a messy input to see how the parser fails.

## Related terms

[Structured output](https://learn.ynteractive.com/content/glossary/structured-output) · [JSON Schema](https://learn.ynteractive.com/content/glossary/json-schema) · [AI Agent node](https://learn.ynteractive.com/content/glossary/ai-agent-node) · [JSON](https://learn.ynteractive.com/content/glossary/json) · [JSON array](https://learn.ynteractive.com/content/glossary/json-array)

## More AI agents terms

[Subagent](https://learn.ynteractive.com/content/glossary/subagent) · [Test Mode](https://learn.ynteractive.com/content/glossary/chatbot-test-mode) · [Tool calling](https://learn.ynteractive.com/content/glossary/tool-calling) · [Workflow tool (agent tool)](https://learn.ynteractive.com/content/glossary/workflow-tool)

## Where you use it: free lessons

- [n8n: Turn Meeting Notes into Action Items in a Google Sheet](https://learn.ynteractive.com/content/meeting-notes-to-action-items-google-sheets-ai-n8n) (n8n, 15 min)
- [AI Receipt Extractor: Receipts to Google Sheets with n8n](https://learn.ynteractive.com/content/ai-receipt-extractor-n8n-google-sheets) (n8n, 12 min)
- [n8n AI Agent Tutorial: Save Social Media Ideas to Google Sheets](https://learn.ynteractive.com/content/n8n-ai-agent-tutorial-google-sheets) (n8n, 12 min)
- [n8n: Read, Add and Update Google Sheets Rows with an AI Step](https://learn.ynteractive.com/content/n8n-google-sheets-read-append-update) (n8n, 12 min)

## Frequently asked questions

**Do I need the parser if I use the OpenAI node's JSON format?**

Not always. For a simple OpenAI step, JSON mode and a clear prompt are often enough. Use the parser with chains and agents, or when the shape must be exact.

**Can the parser return a list?**

Yes. Put an array in the example or schema, such as a list of tasks, and the parser returns it.

[All AI glossary terms, A to Z](https://learn.ynteractive.com/content/glossary) · [Free prompt templates](https://learn.ynteractive.com/content/prompts)
