Chatwoot Developer Docs home page
Search...
⌘K
Introduction
Installation & Setup
Contributing Guide
API Reference
Getting Started
Introduction
Environment Setup
macOS Setup
Ubuntu Setup
Windows Setup
Docker Setup
Make Setup
Project Setup
Setup Guide
Environment Variables
Common Errors
Telegram Setup
Line Setup
Mobile App Setup
Testing
Cypress Testing
Others
Chatwoot APIs
API Documentation
Chatwoot Platform APIs
Security Reports
Translation Guidelines
Community Guidelines
Code of Conduct
Contributors
Chatwoot Developer Docs home page
Search...
⌘K
Search...
Navigation
Others
Chatwoot Community Guidelines
Others
Chatwoot Community Guidelines
Guidelines for participating in the Chatwoot community across all platforms
Chatwoot Community Guidelines
Welcome to the Chatwoot community! These guidelines help ensure our community remains welcoming, productive, and inclusive for everyone.
General Principles
1. Respect and Inclusivity
Everyone is welcome here. Treat all members with respect, regardless of their background, identity, or level of experience.
2. Collaboration Over Conflict
Always approach discussions and feedback with a constructive attitude. We’re all here to learn and grow together.
3. No Spam or Self-Promotion
Unsolicited advertisements, promotions, or spammy links are not allowed. Share valuable content that benefits the community.
Platform-Specific Guidelines
Discord-Specific Guidelines
Our Discord server is where the community gathers for real-time discussions, support, and collaboration.
Channel Etiquette
Stay On Topic
: Each channel has its purpose. Ensure your discussions are relevant to the channel topic.
Use Thread Responses
: For lengthy discussions, use thread replies to keep channels organized.
Search Before Asking
: Check pinned messages and recent discussions before asking questions.
Content Guidelines
No NSFW Content
: This is a professional community. Do not share or promote any NSFW content.
Quality Over Quantity
: Focus on helpful, meaningful contributions rather than frequent low-value messages.
Appropriate Language
: Keep language professional and appropriate for a business environment.
Voice Channels
Microphone Etiquette
: Ensure your microphone is muted when not speaking.
Respect Speaking Time
: Avoid interrupting others and allow everyone to participate.
Background Noise
: Use push-to-talk if you’re in a noisy environment.
Reporting and Support
Report Violations
: If you see someone violating these guidelines, don’t engage. Instead, report it to the moderators.
Use Private Messages
: For sensitive issues, reach out to moderators via private message.
GitHub-Specific Guidelines
GitHub is our primary platform for code collaboration, issue tracking, and project management.
Issue Reporting
Search First
: Before reporting a bug or requesting a feature, search the issues to ensure it hasn’t been addressed already.
Use Templates
: Follow the provided issue templates for bug reports and feature requests.
Provide Details
: Include clear steps to reproduce, expected behavior, and actual behavior.
Stay Updated
: Monitor your issues for questions from maintainers and respond promptly.
Pull Requests
Clear Descriptions
: Ensure your PRs are concise, have a clear title, and are linked to relevant issues.
Follow Style Guide
: Adhere to the existing coding style and conventions.
Test Thoroughly
: Test your changes in multiple scenarios before submitting.
Respond to Reviews
: Address feedback constructively and make requested changes promptly.
Code Review Guidelines
Be Constructive
: Provide specific, actionable feedback rather than general criticism.
Explain Reasoning
: When suggesting changes, explain why the change would improve the code.
Appreciate Good Work
: Acknowledge good code and clever solutions.
Stay Professional
: Keep discussions focused on the code, not the person.
Documentation
Update Documentation
: If your PR introduces a new feature, ensure that it’s documented.
Fix What You See
: If you spot outdated or missing documentation, consider updating it or raising an issue.
Clear Examples
: Provide clear, working examples in documentation.
Community Support
Helping Others
In Discord
Be Patient
: Remember that people have different experience levels
Provide Context
: When helping, explain not just what to do, but why
Share Resources
: Link to relevant documentation or previous discussions
Follow Up
: Check if your help resolved the issue
In GitHub
Helpful Comments
: Provide constructive feedback on issues and PRs
Share Knowledge
: Contribute to discussions with your expertise
Test Solutions
: Help test proposed fixes when possible
Getting Help
Before Asking
Check Documentation
: Review the official docs first
Search History
: Look through previous discussions and issues
Try Solutions
: Attempt basic troubleshooting steps
When Asking
Be Specific
: Provide clear details about your issue
Include Context
: Share relevant environment information
Show Effort
: Explain what you’ve already tried
Be Patient
: Allow time for community members to respond
Consequences for Violating Guidelines
We enforce these guidelines to maintain a positive community environment.
Warning System
First Violation
: For most violations, you will receive a warning from the moderators.
Repeated Minor Violations
: Additional warnings may lead to temporary restrictions.
Immediate Actions
For serious violations, immediate actions may be taken:
Spam or Self-Promotion
: Immediate ban or removal
Harassment or Abuse
: Immediate removal from the community
Sharing Inappropriate Content
: Content removal and potential ban
Appeal Process
If you believe you’ve been unfairly moderated:
Contact Moderators
: Reach out via private message
Provide Context
: Explain your perspective respectfully
Accept Decisions
: Respect final moderation decisions
Refer to
enforcement guidelines
for more details.
Moderator and Admin Privileges
Selection Process
Active contributors to the Chatwoot community, those who consistently offer valuable insights, help, and engagement, may be handpicked as moderators or granted specific privileges.
Criteria for Moderators
Consistent Contribution
: Regular, helpful participation in the community
Good Judgment
: Demonstrated ability to handle conflicts constructively
Technical Knowledge
: Understanding of Chatwoot and related technologies
Time Commitment
: Ability to dedicate time to moderation duties
Responsibilities
Moderators are expected to:
Enforce Guidelines
: Apply community guidelines fairly and consistently
Facilitate Discussions
: Help keep conversations productive and on-topic
Support Users
: Provide assistance and guidance to community members
Report Issues
: Escalate serious violations to administrators
Discretionary Decisions
Appointment Process
: The appointment of moderators and the granting of additional privileges are at the sole discretion of the Chatwoot team.
Review Process
: Moderator performance is reviewed regularly to ensure community standards are maintained.
Admin Privileges
For compliance and security reasons, admin privileges in all Chatwoot communities are reserved exclusively for Chatwoot employees.
Building a Positive Community
Encouraging Participation
Welcome Newcomers
: Help new members feel included and valued
Celebrate Contributions
: Acknowledge helpful contributions and achievements
Share Knowledge
: Contribute your expertise to help others learn
Provide Feedback
: Offer constructive feedback on ideas and solutions
Creating Inclusive Environment
Use Inclusive Language
: Choose words that welcome all community members
Respect Differences
: Value diverse perspectives and experiences
Avoid Assumptions
: Don’t assume others’ backgrounds or knowledge levels
Learn Together
: Approach discussions as learning opportunities
Resources for Community Members
Getting Started
Community Onboarding
:
Discord community
Contributor Guide
:
Contributing documentation
Code of Conduct
:
Detailed guidelines
Stay Connected
Discord Server
: Real-time community discussions
GitHub Discussions
: Long-form technical discussions
Twitter
:
@chatwootapp
for updates
Blog
:
Chatwoot Blog
for articles and insights
Together, we can build an amazing community that supports Chatwoot users and contributors worldwide. Thank you for being part of our journey! 🚀
Previous
Code of Conduct
Code of conduct for Chatwoot community members and contributors
Next
On this page
Chatwoot Community Guidelines
General Principles
1. Respect and Inclusivity
2. Collaboration Over Conflict
3. No Spam or Self-Promotion
Platform-Specific Guidelines
Discord-Specific Guidelines
Channel Etiquette
Content Guidelines
Voice Channels
Reporting and Support
GitHub-Specific Guidelines
Issue Reporting
Pull Requests
Code Review Guidelines
Documentation
Community Support
Helping Others
In Discord
In GitHub
Getting Help
Before Asking
When Asking
Consequences for Violating Guidelines
Warning System
Immediate Actions
Appeal Process
Moderator and Admin Privileges
Selection Process
Criteria for Moderators
Responsibilities
Discretionary Decisions
Admin Privileges
Building a Positive Community
Encouraging Participation
Creating Inclusive Environment
Resources for Community Members
Getting Started
Stay Connected
Assistant
Responses are generated using AI and may contain mistakes.