Convert JSON to JSONC
Drag & drop your .json file here, or click to browse
Converts to JSONC on secure servers · 1 free a day, files up to 25 MB · no signup
Your first conversion each day is free (files up to 25 MB). A $2.99 one-time Day Pass unlocks 24 hours and ends by itself.
Your file is uploaded over an encrypted connection and converted on our server. Add documentation comments to configuration files.
By ChangeThisFile Team · Last updated: October 2026
Your file is uploaded over an encrypted connection and converted on our server. Drop your JSON file, add documentation comments, get JSONC back in seconds.
JSON vs JSONC: Format Comparison
Key differences between the two formats
| Feature | JSON | JSONC |
|---|---|---|
| Comments | Not allowed | Single-line (//) and block (/* */) |
| Standards compliance | RFC 7159 strict | Extended JSON syntax |
| VS Code support | Basic highlighting | Full IntelliSense + comments |
| Configuration use | Limited documentation | Self-documenting configs |
| Maintainability | External docs needed | Inline documentation |
| File extension | .json | .jsonc or .json |
| Parser support | Universal | VS Code, TypeScript compiler, some tools |
When to Convert
Common scenarios where this conversion is useful
VS Code settings documentation
Document complex VS Code settings.json and workspace configurations with explanatory comments for team members and future reference.
TypeScript configuration
Add comments to tsconfig.json explaining compiler options, path mappings, and build settings for better project documentation.
Package.json documentation
Document package.json scripts, dependencies, and configuration options with inline comments for easier project onboarding.
Application configuration
Transform configuration files into self-documenting formats with comments explaining environment variables, feature flags, and settings.
API schema documentation
Add explanatory comments to JSON schema files, API specifications, and data models for better developer experience.
Who Uses This Conversion
Tailored guidance for different workflows
Developers
- Convert JSON config files to JSONC for compatibility with different tools or frameworks
- Transform JSON API responses to JSONC for debugging, logging, or documentation
Data Analysts
- Convert JSON exports to JSONC for importing into spreadsheet software, databases, or BI tools
- Transform JSON datasets to JSONC for sharing with teammates who use different analysis tools
System Administrators
- Convert JSON configuration to JSONC when migrating between infrastructure tools or platforms
- Transform JSON log exports to JSONC for ingesting into monitoring or analysis systems
How to Convert JSON to JSONC
-
1
Drop your JSON file
Drag and drop your JSON file onto the converter, or click to browse and select your configuration file.
-
2
Add comments instantly
Your file is uploaded over an encrypted connection and converted on our server.
-
3
Download JSONC file
Click Download to save your JSONC file, ready for documentation comments and VS Code editing.
Convert JSON to JSONC via API
Integrate this conversion into your pipeline with 3 lines of code. Free tier: 25 conversions/month.
curl -X POST https://changethisfile.com/v1/convert \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "file=@input.json" \ -F "target=jsonc" \ -o output.jsonc --fail
YOUR_API_KEY with your free key — no credit card needed.
Frequently Asked Questions
JSONC (JSON with Comments) extends standard JSON to support single-line (//) and block (/* */) comments, making configuration files self-documenting. Standard JSON doesn't allow comments.
JSONC is supported by VS Code, TypeScript compiler, and many development tools. However, strict JSON parsers will reject JSONC files with comments. Check your tool's documentation.
No, JSONC should only be used for configuration files. API responses must use standard JSON without comments, as most HTTP clients and browsers don't support JSONC.
After converting to JSONC, open the file in VS Code or any text editor. Add // for single-line comments or /* */ for block comments anywhere in the file.
No, the conversion preserves your exact JSON structure, formatting, and values. It only prepares the file to accept comments without changing existing content.
Free conversions accept files up to 25MB. A one-time $2.99 Day Pass raises the limit to 100MB and unlocks unlimited conversions for 24 hours.
Use .jsonc for files that contain comments to signal JSONC format. Some tools auto-detect JSONC in .json files, but .jsonc is clearer for documentation purposes.
Yes, but you'll need to remove all comments first. JSONC with comments cannot be converted to standard JSON without stripping comment syntax.
Yes, VS Code treats .jsonc files as JSON with Comments, providing syntax highlighting, error checking, and IntelliSense support for commented configuration files.
JSONC parsing is slightly slower due to comment processing, but the difference is negligible for configuration files. Use JSONC for development configs where documentation matters.
Node.js doesn't natively support JSONC. You'll need libraries like 'jsonc-parser' or 'strip-json-comments' to read JSONC files in Node.js applications.
The format conversion is reversible, but once you add comments to JSONC, removing them requires manual editing or tools that strip comments before converting back to standard JSON.
Related Conversions
Related Tools
Free tools to edit, optimize, and manage your files.
Ready to convert your file?
Convert JSON to JSONC instantly — free, no signup required.
Start Converting