Skip to content

Contribute ❤️

Believe in our mission and want to support our projects? There are many ways to help.

For everyone

  • Help us grow – star our repositories on GitHub, and follow us on Discord, Bluesky, Mastodon and Reddit.
  • Spread the word – recommend Zen to friends, family and colleagues, or write about it online.
  • Donate – support our work financially through Open Collective.
  • Report a problem – something not working in Zen? Let us know through the issue triage form.
  • Share your ideas – missing something in Zen? Tell us through the feature request form.
  • Help other users – answer questions on Discord and Reddit, and in User Q&A. If a question turns out to be a real problem with Zen, please report it through the issue triage form with as much technical detail as you can. Ask before sharing someone else’s logs, as they may contain personal data.

For technical users

Before contributing, please read our Code of Conduct, including the AI Policy.

  • Bring Zen to your language – add a translation or improve an existing one by following the localisation guide.
  • Improve the filter lists – add rules for ads and trackers that get through, or fix rules that break a site. See the filter lists contributing guide.
  • Suggest an HTTPS exclusion – if an app or site breaks because Zen proxies it, or it handles sensitive data such as banking or government logins, propose its hostname in zen-https-exclusions.
  • Improve the docs – fix a page or propose a new one. See the docs contributing guide.
  • Work on Zen – pick up a good first issue, and ask to be assigned before you start. See Zen’s contributing guide.
  • Give technical feedback – if you have relevant engineering expertise, look through feature requests and ideas.
  • Help shape what’s next – we design substantial changes through RFCs. Comment on open RFCs, or read RFC 0001 to learn how the process works.

However you choose to help – thank you.