Add documentation for included usage alerts (email notifications at 90%/100%) (#59933)

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Joe Clark <31087804+jc-clark@users.noreply.github.com>

Author: 4 people

content/billing/concepts/budgets-and-alerts.md

@@ -32,6 +32,28 @@ Each budget has a type and a scope that define which paid use contributes to spe
 
 You can enable alerts for budgets to receive emails when usage reaches 75%, 90%, and 100% of the budget amount. Emails are sent to account owners and billing managers by default. Additional recipients can be added as needed.
 
+## Included usage alerts
+
+In addition to budget alerts, {% data variables.product.github %} can send email notifications when the included usage for your plan reaches 90% and 100% during a billing period. This helps you stay ahead of unexpected overage charges or workflow disruptions before you exceed your free allowance.
+
+Included usage alerts are available for the following metered products:
+
+* {% data variables.product.prodname_actions %} minutes
+* {% data variables.product.prodname_actions %} storage
+* {% data variables.product.prodname_registry %} bandwidth
+* {% data variables.product.prodname_registry %} storage
+* {% data variables.large_files.product_name_long %} bandwidth
+* {% data variables.large_files.product_name_long %} storage
+* {% data variables.product.prodname_github_codespaces %} core hours
+* {% data variables.product.prodname_github_codespaces %} storage
+
+Each email identifies the account, the product, the approximate usage compared to the included allowance, and the current billing period. The email also includes a direct link to your budgets page for further monitoring.
+
+Enterprise owners, organization owners, personal account owners, and billing managers can opt in or out of these notifications from the **Included usage alerts** control on the "Budgets and alerts" page. For more information, see [AUTOTITLE](/billing/how-tos/set-up-budgets#managing-included-usage-alerts).
+
+> [!NOTE]
+> Included usage alerts are different from budget threshold alerts. Budget threshold alerts notify you when _spending_ reaches a percentage of a dollar budget you have set. Included usage alerts notify you when your plan's _free usage allowance_ is approaching depletion, regardless of whether you have set a budget.
+
 ## Your first billing cycle after creating a budget
 
 When you first create a budget, be aware that the budget applies only to metered usage from the date of its creation onwards. Any use made before you created the budget is not included in the calculations. This means that you may exceed your budget in the first billing cycle after you create your budget, even if you select the option stop usage when the limit is reached.

content/billing/concepts/product-billing/git-lfs.md

@@ -125,6 +125,8 @@ In this example, you would pay for 1.5 GiB of additional storage for the month o
 
 {% data reusables.billing.default-over-quota-behavior %}
 
+You can also receive email notifications when your included {% data variables.large_files.product_name_short %} usage reaches 90% and 100% during a billing period. For more information, see [AUTOTITLE](/billing/concepts/budgets-and-alerts#included-usage-alerts).
+
 ## Further reading
 
 * [AUTOTITLE](/repositories/working-with-files/managing-large-files/about-git-large-file-storage)

content/billing/concepts/product-billing/github-actions.md

@@ -165,6 +165,8 @@ For cached storage, billing charts and reports show only the cost of usage beyon
 
 {% data reusables.billing.default-over-quota-behavior %}
 
+You can also receive email notifications when your included {% data variables.product.prodname_actions %} usage reaches 90% and 100% during a billing period. For more information, see [AUTOTITLE](/billing/concepts/budgets-and-alerts#included-usage-alerts).
+
 ## Further reading
 
 * [AUTOTITLE](/actions/get-started/understand-github-actions)

content/billing/concepts/product-billing/github-codespaces.md

@@ -136,6 +136,8 @@ A {% data variables.enterprise.prodname_managed_user %} cannot be the billable o
 
 {% data reusables.billing.default-over-quota-behavior %}
 
+You can also receive email notifications when your included {% data variables.product.prodname_github_codespaces %} usage reaches 90% and 100% during a billing period. For more information, see [AUTOTITLE](/billing/concepts/budgets-and-alerts#included-usage-alerts).
+
 {% data reusables.codespaces.exporting-changes %}
 
 ## Further reading

content/billing/concepts/product-billing/github-packages.md

@@ -120,6 +120,8 @@ The projected 1.6 GB of storage usage for the month would not exceed your 2 GB l
 
 {% data reusables.billing.default-over-quota-behavior %}
 
+You can also receive email notifications when your included {% data variables.product.prodname_registry %} usage reaches 90% and 100% during a billing period. For more information, see [AUTOTITLE](/billing/concepts/budgets-and-alerts#included-usage-alerts).
+
 ## Further reading
 
 * [AUTOTITLE](/packages/learn-github-packages/introduction-to-github-packages)

content/billing/how-tos/set-up-budgets.md

@@ -69,6 +69,15 @@ You can set budgets and receive alerts when your usage of a product reaches 75%,
 
 To edit or delete a budget, on the "Budget and alerts" page, click **Edit** or **Delete** next to the budget you want to edit or delete. Follow the prompts.
 
+### Managing included usage alerts for your personal account
+
+{% data variables.product.github %} can send you email notifications when the included usage for your plan reaches 90% and 100% during a billing period. To learn more about what these alerts cover, see [AUTOTITLE](/billing/concepts/budgets-and-alerts#included-usage-alerts).
+
+{% data reusables.user-settings.access_billing_settings_url %}
+
+1. Click **Budgets and alerts**.
+1. Under "Included usage alerts", select or clear **Receive alerts when my included usage reaches 90% and 100%** to opt in or out of email notifications.
+
 ## Managing budgets for your organization or enterprise
 
 > [!IMPORTANT]
@@ -115,6 +124,13 @@ To limit spending on premium requests across all features, enable "Bundled premi
 
 {% data reusables.billing.budget-create-button %}
 
+### Managing included usage alerts
+
+{% data variables.product.github %} can send email notifications when the included usage for your account reaches 90% and 100% during a billing period. To learn more about what these alerts cover, see [AUTOTITLE](/billing/concepts/budgets-and-alerts#included-usage-alerts).
+
+1. Navigate to the "Budgets and alerts" view. See [Viewing budgets](#viewing-budgets).
+1. Under "Included usage alerts", select or clear **Receive alerts when my included usage reaches 90% and 100%** to opt in or out of email notifications.
+
 ### Editing or deleting a budget
 
 >[!IMPORTANT] Deleting a budget may remove any limits on spending, depending on your other existing budgets.

content/billing/how-tos/set-up-payment/manage-payment-info.md

@@ -52,7 +52,7 @@ You can view your payment history, including the date, amount, and payment metho
 
 ## Managing billing contacts
 
-Organizations and enterprises can add contacts to receive emails with billing notifications for payments and budget threshold alerts. One of the contacts is defined as the primary contact.
+Organizations and enterprises can add contacts to receive emails with billing notifications for payments, budget threshold alerts, and included usage alerts. One of the contacts is defined as the primary contact.
 
 ### Organization billing contacts
 

content/billing/reference/product-usage-included.md

@@ -97,4 +97,7 @@ The table below shows the usage available in each plan. When you exceed these am
 </table>
 
 > [!TIP]
-> For information about included requests for {% data variables.product.prodname_copilot %} plans, see [AUTOTITLE](/copilot/about-github-copilot/plans-for-github-copilot).
+> You can receive email notifications when your included usage reaches 90% and 100% during a billing period. To opt in, see [AUTOTITLE](/billing/how-tos/set-up-budgets#managing-included-usage-alerts).
+
+For information about included requests for {% data variables.product.prodname_copilot %} plans, see [AUTOTITLE](/copilot/about-github-copilot/plans-for-github-copilot).
+

data/reusables/user-settings/access_billing_settings_url.md

@@ -1 +1 @@
-1. Open your billing overview page: https://github.com/settings/billing.
+1. Open your billing overview page: [https://github.com/settings/billing](https://github.com/settings/billing?ref_product=github&ref_type=engagement&ref_style=text).