Getting started with GitHub Sponsors

This quickstart guide walks you through several ways you can start pursuing funding for your open source work.

|
| 4 minutes

Are you interested in GitHub Sponsors but don’t know where to start? Do you have questions about whether you should sign up as an individual or as an organization? This guide walks you through several ways you can start pursuing funding for your open source work.

We’ll cover how to sign up and receive funds, as an:

And we’ll review a few other topics on how to:

How do I receive funds for open source work as an individual?

If you have a GitHub account and contribute to open source, you can apply to become a sponsored developer. This application is where you can share details about your open source work, which is part of determining your eligibility for the GitHub Sponsors Matching Fund. Applicants with a bank account in any of our supported countries will receive an email on how to get started within two weeks.  

You can create your sponsorship profile as soon as you receive the welcome email. Your profile is an opportunity to share your work and how you can benefit from sponsorships. After submitting your profile, we’ll review it and let you know when it’s live to share with friends, on social media, in conversations on GitHub, and more.

An example of a sponsored developer’s sponsorship profile.

Once you start to receive funds, you’re responsible for evaluating and paying your own taxes. GitHub does not withhold tax from GitHub Sponsors payments.

Learn more

How do we receive funds as a GitHub organization with a bank account?

If you work on a team that would like to receive funds, and your group has a bank account in any of our supported countries, you can sign up for GitHub Sponsors as an organization.

Select your organization from the sign up dropdown.

Learn more

How do we receive funds as a GitHub organization without a bank account?

If your organization is ready to receive funding but doesn’t have a bank account, sign up with a fiscal host like Open Source Collective

Once you have a fiscal host, your GitHub organization can sign up for sponsorship. When you sign up for GitHub Sponsors, select “This organization is using a fiscal host.”

How do I display my GitHub Sponsors profile on a project?

As a sponsored developer, you can display a sponsor button on your repository, so others can support your project.

  1. Add a FUNDING.yml file to your foobar repository.
    # repo:     your_github_handle/project_name
    # filename: FUNDING.YML
    
    github: your_github_handle 
  2. Enable Sponsorships in the Settings page.
    Check the “Sponsorships” option in the Settings page.
  3. Visit your repository where you enabled the Sponsor button. The button is now displayed for future sponsors.

Your sponsor button will appear in the top right of your project’s page.

Learn more

How do I display Patreon, Open Collective, or another external funding platform on a project?

You can display one or more external funding options by adding them to your FUNDING.yml file:

patreon:            patreon_username
open_collective:    open_collective_username
ko_fi:              ko_fi_username
tidelift:           tidelift_package_name
community_bridge:   community_bridge_username
liberapay:          liberapay_username
issuehunt:          issuehunt_username
otechie:            otechie_username
custom:             ["custom_url.com", “another_custom_url.com”]

The sponsor modal shows external funding sources if listed.

Learn more

How do I add sponsor buttons to all of my projects?

If you have a bunch of projects, it’s a hassle to create a FUNDING.yml file for every individual repository. Instead, you can add a default FUNDING.yml file for all of them. This default can be overridden for each repository.

Create a default FUNDING.yml file for all projects in your personal .github repository.

# repo:     your_github_handle/.github
# filename: FUNDING.YML

github: your_name

If the projects live within a GitHub organization instead of your personal account, follow the same process—just add FUNDING.yml to the organization’s .github repository instead.

Learn more

How do I give credit to other team members working on my project?

If you start working with another developer on your project, you may want to add their GitHub Sponsors profile to the project. You can update the FUNDING.yml file for the project to make their profile visible on the modal for the Sponsors button.

# repo:     your_github_handle/foobar
# filename: FUNDING.YML

github: [your_github_handle, friend]

The sponsor modal shows up to four developers listed in the FUNDING.yml file.

Related posts