Contributing code to Adblock Plus

Finding something to work on

Note that most of our projects are also on GitHub, if you prefer that.

We're keeping track of all the things we want to fix and improve on our issue tracker.

If you already know what you want to do, feel free to create an issue there. If not, have a look at the issues marked as goodfirstbug. If you don't find anything interesting, feel free to pick any unassigned issue, ideally P4.

In any case, please write a comment saying that you'd like to work on something before you get started. That way we can assign the issue to you, to ensure no one else starts to work on the same thing.

Getting in touch

Need help or want to chat? Join our IRC channel: #adblockplus on (there is also a web-based client). While we are a globally distributed team, there are times when most of the team is not online. Please note that we cannot reply to you if you are offline.

Submitting a patch

Once you've made and tested your changes, first make sure they're in line with our coding style.

Now you can send us your patch, ideally by uploading it to But you can also attach a patch file to the issue, or create a pull request on GitHub.

Finally, before we can accept your patch, you need to sign the contributor agreement. Please print it out, sign it, scan that or take a picture of it and send it to one of your reviewers.

Becoming a committer

If you intend to contribute to a project on a regular basis, you might want to become a committer.