​

Getting Support

The JSON Schema community offers multiple channels for getting help, depending on your needs.

​

Support Channels

​

Slack Workspace

Join the JSON Schema Slack for real-time discussions and support. Recommended channels:

• #general: General questions and discussions about JSON Schema
• #specification: Questions about the JSON Schema specification and its development
• #implementations: For implementers of JSON Schema libraries and tools
• #help: Get help with using JSON Schema

Slack is best for:

• Quick questions
• General discussions
• Connecting with other community members
• Real-time collaboration

​

GitHub Issues

Use GitHub Issues for:

• Reporting bugs in the specification
• Proposing enhancements
• Discussing specific technical issues
• Tracking feature requests

Before creating an issue:

• Search existing issues to avoid duplicates
• Ensure your question is about the specification itself
• For implementation-specific questions, check the relevant implementation’s repository

GitHub Issues should identify a problem, enhancement, or use case, and propose a course of action for the specification draft.

​

Stack Overflow

For usage questions and implementation help, consider using Stack Overflow with the jsonschema tag. Good for:

• How-to questions
• Implementation-specific questions
• Troubleshooting validation errors
• Schema design questions

​

What to Include When Asking for Help

To get the best assistance, please include:

1. Context: What are you trying to achieve?
2. Example: Provide a minimal reproducible example (schema and instance data)
3. Expected vs. Actual: What did you expect to happen? What actually happened?
4. Environment: Which JSON Schema version and implementation are you using?
5. Research: What have you already tried?

​

Implementation-Specific Support

If your question is specific to a particular JSON Schema implementation or library:

1. Check the implementation’s documentation
2. Look for the implementation’s GitHub repository
3. Check if the implementation has its own support channels
4. Use the #implementations channel on Slack for implementation-related discussions

​

Security Issues

​

Reporting Security Issues

The JSON Schema project does not house any implementation of JSON Schema itself. If you have found a security issue: In a JSON Schema implementation:

• Contact the appropriate maintainers per the project’s security reporting guidelines
• Follow responsible disclosure practices

In the JSON Schema specification or organization repositories:

• Use the GitHub Security Advisory at: https://github.com/json-schema-org/json-schema-spec/security/advisories/new
• The JSON Schema TSC will review and respond to all security reports
• Please follow coordinated disclosure

For implementation maintainers:

• Consider adding a security policy
• For assistance with security reports or remediation, reach out on Slack in the #implementations channel to request a temporary private channel

​

Types of Questions

​

Specification Questions

Questions about how the JSON Schema specification works:

• Best channel: GitHub Issues or #specification on Slack
• Examples: “What does this keyword mean?” “Is this behavior defined?”

​

Usage Questions

Questions about how to use JSON Schema:

• Best channel: Stack Overflow or #help on Slack
• Examples: “How do I validate X?” “What schema should I use for Y?”

​

Implementation Questions

Questions about specific libraries or tools:

• Best channel: Implementation’s repository or #implementations on Slack
• Examples: “How do I use library X?” “Why is validator Y behaving this way?”

​

Contribution Questions

Questions about contributing to JSON Schema:

• Best channel: #specification on Slack or GitHub Discussions
• See also: Contributing Guide

​

Response Times

JSON Schema is an open-source project maintained by volunteers. Response times vary:

• Slack: Often faster for simple questions (hours to days)
• GitHub Issues: May take several days to weeks depending on complexity
• Security reports: Reviewed and responded to as soon as possible

Please be patient and respectful of volunteer time.

​

Community Guidelines

When seeking support:

• Be respectful and courteous
• Follow the Code of Conduct
• Search for existing answers before asking
• Provide clear, complete information
• Follow up if you find a solution
• Consider helping others once you’ve learned

​

Commercial Support

Some organizations and individuals offer commercial support, consulting, or training for JSON Schema. Check the JSON Schema website for information about available services.

​

Contributing Back

If you received helpful support:

• Consider contributing to the documentation
• Help answer questions from other users
• Share your learnings through blog posts or examples
• Support the project financially through Open Collective

Thank you for being part of the JSON Schema community!