Skip to content

Commit 8e178ca

Browse files
authored
Cost centers: Update existing content to make behavior clearer (#58226)
1 parent 60bb46b commit 8e178ca

File tree

6 files changed

+37
-19
lines changed

6 files changed

+37
-19
lines changed
70.8 KB
Loading
540 KB
Loading

content/billing/reference/cost-center-allocation.md

Lines changed: 28 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -24,31 +24,39 @@ This article contains reference information for how spending is assigned to cost
2424
| ------- | ----------------------------------------------------- |
2525
| {% data variables.product.prodname_actions %} | The repository or organization where the workflow runs. |
2626
| {% data variables.product.prodname_github_codespaces %} | The repository or organization where the codespace is created. |
27-
| {% data variables.product.prodname_copilot %} | The user who receives the license (priority), or the organization that is billed for the {% data variables.product.prodname_copilot_short %} license. |
28-
| Git Large File Storage | The repository or organization where Git LFS is used. |
29-
| {% data variables.product.prodname_GH_cs_and_sp %} | The user who receives the license. |
27+
| {% data variables.product.prodname_copilot %} license | The user who receives the license (priority), or the organization that is billed for the {% data variables.product.prodname_copilot_short %} license. |
3028
| {% data variables.product.prodname_enterprise %} | The user who receives the license (priority), or the organization that is billed for the license. |
29+
| Git Large File Storage | The repository or organization where Git LFS is used. |
3130
| {% data variables.product.prodname_registry %} | The repository or organization that owns the package. |
31+
| {% data variables.product.prodname_prus_caps %} | The user who triggered the use of the {% data variables.product.prodname_pru %} (priority), or the organization they belong to. |
32+
| {% data variables.product.prodname_GH_cs_and_sp %} | A user who uses a license. |
3233

3334
## Details for license-based products
3435

35-
To ensure your cost centers reflect spending as intended, it's important to understand how spending is allocated to cost centers for license-based products like {% data variables.product.prodname_copilot %}, and how changes are reflected in your bill.
36+
To ensure your cost centers reflect spending as intended, it's important to understand how the cost of licenses is allocated to cost centers, and how changes are reflected in your bill.
3637

37-
### {% data variables.product.prodname_copilot %}
38+
### {% data variables.product.prodname_GH_cs_and_sp %}
3839

39-
* If a user belongs to a cost center, all usage associated with the user is charged to the cost center.
40-
* If a user does not belong to any cost center but the organization that is billed for the {% data variables.product.prodname_copilot_short %} license does, all usage associated with the user is charged to that cost center.
41-
* If the user receives access to {% data variables.product.prodname_copilot_short %} through **multiple organizations**, only one of the organizations is billed, and any cost center containing that organization is charged accordingly. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-subscription-for-your-enterprise/about-billing-for-github-copilot-in-your-enterprise#about-seat-assignment-for-copilot-in-your-enterprise).
40+
| User associated with a cost center | License usage charged |
41+
|--|--|
42+
| Direct assignment | To the cost center the user is assigned to |
43+
| By organization membership only | To the enterprise |
4244

43-
### {% data variables.product.prodname_GH_cs_and_sp %}
45+
### {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_copilot %}
4446

45-
* If a user belongs to a cost center, licenses consumed by the user are charged to the cost center.
46-
* If a user does not belong to any cost center, licenses consumed by the user are charged to the enterprise.
47+
Cost center allocation is slightly different for {% data variables.product.prodname_enterprise %} licenses and {% data variables.product.prodname_copilot %} licenses and usage.
4748

48-
### {% data variables.product.prodname_enterprise %}
49+
| User associated with a cost center | {% data variables.product.prodname_copilot_short %} license granted | License and product costs charged |
50+
|--|--|--|
51+
| Direct assignment | By any organization | To the cost center the user is assigned to |
52+
| By organization membership only | By an organization assigned to a cost center | To the **cost center** the organization belongs to. If the organization does not belong to a cost center, to the **enterprise** |
4953

50-
* If a user belongs to a cost center, the license consumed by the user is charged to the cost center.
51-
* If a user does not belong to any cost center, the license consumed by the user is charged to the enterprise.
54+
Users who belong to multiple organizations in an enterprise or who receive a {% data variables.product.prodname_copilot_short %} license from multiple organizations:
55+
56+
* **{% data variables.product.prodname_enterprise %}** license usage is allocated to the oldest organization and charges are allocated to the cost center containing that organization.
57+
* **{% data variables.product.prodname_copilot_short %}** license and product usage is allocated to one of the organizations and charges are allocated to the cost center containing that organization.
58+
59+
See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-subscription-for-your-enterprise/about-billing-for-github-copilot-in-your-enterprise#about-seat-assignment-for-copilot-in-your-enterprise).
5260

5361
## Understanding cost center usage and attribution
5462

@@ -86,6 +94,8 @@ The following example illustrates how usage is assigned to cost centers for lice
8694

8795
### The users
8896

97+
![Diagram illustrating the description of four users and their organization membership.](/assets/images/help/billing/cost-center-example-1.png)
98+
8999
There are four users, each a member of one or more organizations in the enterprise.
90100

91101
| User | Organization membership |
@@ -114,12 +124,14 @@ There are two cost centers in the enterprise, each with different users or organ
114124

115125
The following table illustrates how spending for each user is allocated to a cost center based on their membership of an organization or cost center. Any usage not assigned to a cost center is categorized as "Enterprise Only" spending.
116126

127+
![Diagram illustrating the assignment of users and organizations to cost centers, with the allocation of costs for the four users.](/assets/images/help/billing/cost-center-example-2.png)
128+
117129
{% rowheaders %}
118130

119131
| | Copilot charges | GHSP charges | GHE charges | Explanation |
120132
| ----------- | --------------- | ------------ | ----------- | ----------- |
121133
| Cost Center A | `user-1`, `user-3` | `user-1`, `user-3` | `user-1`, `user-3` | These users are assigned directly to the cost center. |
122-
| Cost Center B | `user-2`, `user-4` | {% octicon "dash" aria-label="Not applicable" %} | {% octicon "dash" aria-label="Not applicable" %} | These users aren't directly assigned to a cost center, so Copilot charges are assigned based on organization membership, whereas GHSP and GHE default to enterprise spending. |
123-
| Enterprise Only (default) | {% octicon "dash" aria-label="Not applicable" %} | `user-2`, `user-4` | `user-2`, `user-4` | These users aren't directly assigned to a cost center, so GHSP and GHE default to enterprise spending. |
134+
| Cost Center B | `user-2`, `user-4` | {% octicon "dash" aria-label="Not applicable" %} | `user-2`, `user-4` | These users aren't directly assigned to a cost center, so Copilot and GHE charges are assigned based on organization membership, whereas GHSP defaults to enterprise spending. |
135+
| Enterprise Only (default) | {% octicon "dash" aria-label="Not applicable" %} | `user-2`, `user-4` | {% octicon "dash" aria-label="Not applicable" %} | These users aren't directly assigned to a cost center, so GHSP defaults to enterprise spending. |
124136

125137
{% endrowheaders %}
Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
To allocate metered spending to a cost center, you add repositories, organizations, or users to the cost center.
22

3-
* For **metered** products like {% data variables.product.prodname_actions %}, cost centers are charged based on the **repositories or organizations** in the cost center, as this is where the usage takes place.
4-
* For **metered license-based** products like {% data variables.product.prodname_copilot %}, cost centers are charged based on the **users** in the cost center.
3+
* For **usage-based** products, like {% data variables.product.prodname_actions %}, cost centers are charged based on the **repositories or organizations** in the cost center, as this is where the usage takes place.
4+
* For **license-based** products, like {% data variables.product.prodname_copilot %}, cost centers are charged based on the **users** in the cost center.
5+
* For products billed by **{% data variables.product.prodname_pru %}** usage, like {% data variables.copilot.copilot_coding_agent %}, cost centers are also charged based on the **users** in the cost center.
56

67
Cost centers only apply to metered usage, and do not work with volume or subscription billing.

data/variables/copilot.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ copilot_free_short: 'Copilot Free'
1717

1818
## Copilot billing
1919
# Price per additional premium request
20-
additional_premium_requests: '$0.04 USD'
20+
additional_premium_requests: '$0.04 USD' # Note that these are also used to bill other products
2121
# Price per month for Copilot Pro
2222
cfi_price_per_month: '$10 USD'
2323
# Price per year for Copilot Pro

data/variables/product.yml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -308,6 +308,11 @@ prodname_arctic_vault: 'Arctic Code Vault'
308308
prodname_copilot: 'GitHub Copilot'
309309
prodname_copilot_short: 'Copilot'
310310

311+
# Premium requests (used to bill products like Copilot, Spark)
312+
prodname_pru: 'premium request'
313+
prodname_prus: 'premium requests'
314+
prodname_prus_caps: 'Premium requests'
315+
311316
# GitHub Spark
312317
prodname_spark: 'GitHub Spark'
313318
prodname_spark_short: 'Spark'

0 commit comments

Comments
 (0)