Frequently Asked Questions
General Questions
What is sponsoredissues.org?

sponsoredissues.org is a platform that allows GitHub Sponsors donors to assign their donations to specific GitHub issues. This gives users voting power over which features and fixes get prioritized, while helping maintainers understand what matters most to their community.

How is this different from other issue bounty platforms?

Unlike bounty platforms where money is held until work is complete, sponsoredissues.org works with GitHub Sponsors donations that have already been given (unconditionally!) to the maintainer. The funds assigned to an issue on sponsoredissues.org merely let the maintainer know that the issue is important to users, and there is no formal obligation to resolve the issue within any specific timeframe.

Is sponsoredissues.org free to use?

Yes, the platform is free to use for both maintainers and users. If you want to support the site, or if you want vote for specific features/fixes, you can donate to me on GitHub Sponsors.

For Maintainers
How do I get started as a maintainer?

To get started as a maintainer:

  1. Set up a GitHub Sponsors profile for your GitHub account.
  2. Install the GitHub App for sponsoredissues.org.
  3. Add the sponsoredissues.org label to GitHub issues you want to make sponsorable.
  4. Recommended: Edit the README.md for your repo and add a link to your sponsored issues page. You can get the URL for the sponsored issues page by replacing github.com with sponsoredissues.org in the GitHub repo URL.

That's it! The issues you tagged should now be fundable on sponsoredissues.org.

Which issues can be sponsored?

Only issues that you've explicitly tagged with the sponsoredissues.org label on GitHub will be listed on sponsoredissues.org. This helps ensure that your users can only fund issues that are technically feasible and align with your project goals.

You should think carefully about which issues you tag with sponsoredissues.org! As general rule, make sure that you are interested in doing the work, and that you have a good implementation plan before tagging the issue. That will save both you and your users a lot of unnecessary churn.

Would I be giving up creative control of my project to my donors?

No, you maintain creative control of your project, because you decide which issues are "sponsorable", i.e. which issues have the sponsoredissues.org label on GitHub. You should only tag an issue if you think the requested feature/fix is reasonable and you want to do the work. See also: Which issues can be sponsored?

When do I receive the donations?

User donations on GitHub Sponsors are immediately sent to the maintainer, and sponsoredissues.org has no effect on when payments are sent. As such, there is no requirement for maintainers to resolve specific issues before getting paid. See also: How is this different from other issue bounty platforms?

Am I required to complete sponsored issues?

No. All contributions on sponsoredissues.org are donations, not contracts or bounties. You have no formal obligation to resolve funded issues in any particular timeframe (or at all). The funding is meant to help encourage and prioritize work, not create legal obligations.

For Users/Donors
How do I vote for issues on sponsoredissues.org?

To vote for issues:

  1. Make a donation to the maintainer on GitHub Sponsors. You may choose a one time donation or a monthly subscription (both options work with sponsoredissues.org).
  2. Sign in to sponsoredissues.org with your GitHub account.
  3. Navigate to the repo page on sponsoredissues.org. You can get the URL for a repo page by replacing github.com with sponsoredissues.org in the URL for the GitHub repo (e.g. https://github.com/benvvalk/sponsoredissues.org -> https://sponsoredissues.org/benvvalk/sponsoredissues.org).
  4. Allocate portions of your GitHub Sponsors donation to specific issues, using the "Add or Remove Funds" button next to the individual issues.

The issue listing for a repo is sorted and ranked by donation total, to help maintainers see which issues have the most community support.

Do I need an account to donate?

You need a GitHub account to donate through GitHub Sponsors (which is how the actual money transfer happens). To allocate your donations to specific issues on sponsoredissues.org, you'll need to sign in with that GitHub account so the platform can verify your sponsorship.

I created a GitHub issue, and I want to donate to it. Why isn't it listed on sponsoredissues.org?

Not every GitHub issue is automatically "sponsorable". You will need to ask the maintainer to approve the issue sponsorship by adding the sponsoredissues.org label. This helps ensure that the requested feature/fix is technically feasible, and aligns with the maintainer's goals for the project.

Can I get a refund if an issue isn't completed?

Sorry, no. Since all payment processing is handled by GitHub Sponsors, we can't give refunds. However, you can adjust or remove your issue allocations at any time before the issue is closed. For questions about refunding your GitHub Sponsors donation, you'll need to contact GitHub support.

Can I change how my donation is allocated?

Yes! You can reallocate your GitHub Sponsors donation among different issues at any time, as long as the issues are still open. Simply visit the repository's issue page and adjust your allocations.

Technical Questions
How does sponsoredissues.org verify GitHub Sponsors donations?

The platform uses GitHub's API to verify active sponsorships and donation amounts. When you sign in with GitHub, sponsoredissues.org can check which maintainers you're sponsoring and for how much, ensuring you can only allocate donations you've actually made.

What happens when an issue is closed?

When an issue is closed on GitHub, funding allocations for that issue are locked. The maintainer has already received the donations (as they're forwarded immediately), and donors can no longer adjust their allocations for that specific issue.

Is the source code available?

Yes! sponsoredissues.org is open source and published on GitHub with an Affero GPL license. You can view the code, report issues, or even contribute to the platform itself at github.com/benvvalk/sponsoredissues.org.