Skip to content

Add workaround for when organization’s active sponsorships are canceled after joining an enterprise with Azure billing #39243

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

ernest-phillips
Copy link

Why:

Closes https://github.com/github/sponsors/issues/6228

What's being changed (if available, include any code snippets, screenshots, or gifs):

This PR updates the documentation for adding an existing organization to an enterprise, specifically addressing the impact on GitHub Sponsors when the enterprise uses Azure billing. It adds clear guidance for organizations whose sponsorships are canceled during this process and provides a workaround so they can continue to use GitHub Sponsors.

Problem

When an existing organization is added to an enterprise account with Azure metered billing, all active GitHub Sponsors sponsorships are canceled. Organizations are unable to reactivate sponsorships or add a payment method due to enterprise billing restrictions, and current documentation does not provide clear next steps for affected organizations.

Solution

This PR adds a new subsection to the “Changes when adding an existing organization” section. It explains why sponsorships are canceled, clarifies that reactivation is not possible under Azure billing, and recommends creating a standalone "shell" organization to manage sponsorships outside the enterprise billing structure.

Check off the following:

  • A subject matter expert (SME) has reviewed the technical accuracy of the content in this PR. In most cases, the author can be the SME. Open source contributions may require an SME review from GitHub staff.
  • The changes in this PR meet the docs fundamentals that are required for all content.
  • All CI checks are passing and the changes look good in the review environment.
    Here’s a draft for your pull request description:

Checklist

  • Added new guidance for GitHub Sponsors and Azure billing scenario
  • Provided a workaround for affected organizations
  • Updated documentation structure for clarity

@Copilot Copilot AI review requested due to automatic review settings July 9, 2025 19:17
Copy link

welcome bot commented Jul 9, 2025

Thanks for opening this pull request! A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR fixes linting issues with headings and improves documentation for organizations being added to enterprises with Azure billing. The changes primarily address GitHub Sponsors compatibility issues when organizations join enterprises using Azure metered billing.

  • Adds comprehensive guidance for handling GitHub Sponsors cancellations under Azure billing
  • Provides a workaround using "shell" organizations for continued sponsorship management
  • Fixes punctuation formatting in step-by-step instructions
Comments suppressed due to low confidence (1)

content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise.md:74

  • This line uses 'GitHub Sponsors' instead of the defined variable. According to the content guidelines, you should use {% data variables.product.prodname_sponsors %} instead of hardcoded text for product names.
To continue using GitHub Sponsors, create a new, separate "shell" organization that is not linked to your enterprise account or Azure billing. You can then use this shell organization to manage sponsorships independently of your enterprise’s billing setup.

Copy link
Contributor

github-actions bot commented Jul 9, 2025

How to review these changes 👓

Thank you for your contribution. To review these changes, choose one of the following options:

A Hubber will need to deploy your changes internally to review.

Table of review links

Note: Please update the URL for your staging server or codespace.

The table shows the files in the content directory that were changed in this pull request. This helps you review your changes on a staging server. Changes to the data directory are not included in this table.

Source Review Production What Changed
admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise.md ghec
ghec

Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server

🤖 This comment is automatically generated.

@github-actions github-actions bot added the triage Do not begin working on this issue until triaged by the team label Jul 9, 2025
@Sharra-writes Sharra-writes added content This issue or pull request belongs to the Docs Content team administering a repo Content relating to administering a repo waiting for review Issue/PR is waiting for a writer's review and removed triage Do not begin working on this issue until triaged by the team labels Jul 9, 2025
@ernest-phillips ernest-phillips changed the title Fix linting issues with headings Add workaround for when organization’s active sponsorships are canceled after joining an enterprise with Azure billing Jul 9, 2025
@ernest-phillips ernest-phillips marked this pull request as draft July 9, 2025 20:27
@ernest-phillips ernest-phillips marked this pull request as ready for review July 10, 2025 15:01
@@ -76,9 +91,9 @@ During a trial of {% data variables.product.prodname_ghe_cloud %}, you can creat
1. In the left sidebar, click **Organizations**.
{%- endif %}
1. Above the list of organizations, click **New organization**.
1. Under "Organization name", type a name for your organization.
1. Under "Organization name," type a name for your organization.
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
administering a repo Content relating to administering a repo content This issue or pull request belongs to the Docs Content team waiting for review Issue/PR is waiting for a writer's review
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants