Frequently Asked Questions

Everything you need to know about TOON format and TOON Tools

General

What is TOON format?

TOON (Token-Oriented Object Notation) is a data serialization format optimized for LLM token efficiency. It reduces token usage by 30-60% compared to JSON while maintaining all data structure and information.

Is TOON Tools free to use?

Yes! TOON Tools is 100% free with no signup required. All tools run in your browser for maximum privacy and speed.

Do you store my data?

No. All conversions happen entirely in your browser using JavaScript and WebAssembly. Your data never leaves your device and is never uploaded to any server.

Can I use TOON in production?

Absolutely! The @toon-format/toon library is stable, well-tested, and used by many developers. It supports Node.js, browsers, and has TypeScript definitions.

Technical

How does TOON reduce token usage?

TOON uses several techniques: removing unnecessary whitespace, optimizing key-value pair syntax, using compact data type representations, and employing efficient encoding for common patterns.

Is TOON compatible with all data types?

TOON supports all standard JSON data types: objects, arrays, strings, numbers, booleans, and null. It also preserves nested structures perfectly.

Can I convert TOON back to JSON?

Yes! TOON is fully reversible. You can convert JSON→TOON and TOON→JSON without any data loss. Both encode() and decode() functions are available.

What programming languages support TOON?

The official library supports JavaScript/TypeScript (Node.js and browsers). Community libraries exist for Python, Go, and Rust. You can also use the format manually in any language.

Use Cases

When should I use TOON?

Use TOON when working with LLMs (ChatGPT, Claude, etc.), storing data in token-limited contexts, or when you want to reduce API costs. It's perfect for chat histories, API responses, and configuration files.

Does TOON work with OpenAI API?

Yes! TOON works great with OpenAI, Anthropic, and other LLM APIs. Simply convert your data to TOON before sending it and convert back when receiving responses.

Can I use TOON for RAG applications?

Definitely! TOON is excellent for RAG (Retrieval-Augmented Generation) since it lets you fit more context in the same token budget, improving your LLM's knowledge base efficiency.

Is TOON good for large datasets?

Yes, TOON handles large datasets efficiently. The conversion is fast (<1ms for most data), and larger files see even better token savings (often 50%+).

Tools & Features

What converters do you offer?

We offer JSON↔TOON, CSV↔TOON, YAML↔TOON, XML↔TOON converters, plus a Token Counter, Validator, Batch Converter, and Interactive Playground.

Can I convert multiple files at once?

Yes! Use our Batch Converter tool to upload and convert multiple files simultaneously. Perfect for migrating existing data to TOON format.

Do you have an API?

Currently, all tools are client-side only. However, you can easily integrate the @toon-format/toon library into your own API using npm.

Is there a CLI tool?

Yes! Install the toon-cli package from npm: `npm install -g toon-cli`. Then use commands like `toon encode file.json` or `toon decode file.toon`.

Still have questions?

Check out our documentation or join the community on GitHub