Amazon CodeCatalyst will no longer be open to new customers starting on November 7, 2025. If you would like to use the service, please sign up prior to November 7, 2025. For more information, see [Migrating from Amazon CodeCatalyst](https://docs.aws.amazon.com/codecatalyst/latest/userguide/migration.html).

# Administering billing
<a name="managing-billing"></a>

Your CodeCatalyst space uses resources, such as Dev Environments and compute, that are charged based on separate subscription tiers. To check your usage and to view pricing for each subscription tier, see the **Billing** tab for your space.

You can view or change your CodeCatalyst subscription for your space. CodeCatalyst has the following tiers available.
+ Free
+ Standard
+ Enterprise

For more information about billing and rates, see the [Amazon CodeCatalyst pricing page](https://codecatalyst.aws/explore/pricing).

Additional considerations:
+ All spaces are required to have a billing account, even if the usage does not exceed the Free tier.
+ AWS is the billing provider for CodeCatalyst. The account you use for billing must be an AWS account.
+ Billing is configured at the space level. Multiple AWS accounts can be associated with a space, but only one can be active for CodeCatalyst billing at a time. An AWS account can be used as a billing account for more than one space in CodeCatalyst. The AWS account that is specified as the billing account for your CodeCatalyst space has different quotas from other account connections for a space. For more information, see [Quotas](https://docs.aws.amazon.com/codecatalyst/latest/userguide/quotas.html) in the *CodeCatalyst User Guide*.
+ You can view your CodeCatalyst charges on your AWS invoice, including current charges. Billing data is updated regularly on the AWS Management Console page for AWS Billing. 

Here is one possible flow to set up billing in CodeCatalyst.

Mary Major is a **Space administrator** for a CodeCatalyst space. Mary works with the AWS administrator for the AWS account that was added to her space in CodeCatalyst when it was created and so defaults as the billing account. Mary can also specify a different account as a billing account for her space. Mary initially set up her subscription to default to the Free tier. Mary knows that hitting the maximum can halt services for the rest of her space on the Free tier, so she periodically reviews usage for her space on the CodeCatalyst console **Billing** tab. Mary views the pricing subscription for the Standard tier, and after the space grows in size, Mary decides to use the CodeCatalyst billing page to change the subscription tier from the Free tier to the Standard tier. Mary works with her AWS administrator to access her AWS invoice and views the charges for usage beyond the Free tier in CodeCatalyst.

# Setting up a billing account
<a name="managing-billing-add-account"></a>

To set up billing, you must add an authorized AWS account to your CodeCatalyst space and configure it for billing. Before you can set up a billing account, you must work with your AWS administrator to complete the prerequisites in the following procedure.

Where necessary, these steps link you to the procedures in this guide for adding the AWS account you want to use for billing to your space by creating a connection.

You must have the **Space administrator** role in CodeCatalyst and have administrator permissions for your account in AWS to manage billing.

## Step 1: Add the billing account to your space
<a name="managing-billing-add-account-step"></a>

To choose a new account for billing, you must have completed the steps to add it to your space. Complete the steps as detailed in [Administering connected accounts](managing-accounts.md).

You must have the **Space administrator** role in CodeCatalyst and have administrator permissions for your account in AWS to manage billing.

## Step 2: Choose the billing account in CodeCatalyst
<a name="managing-billing-add-account-details"></a>

Next, specify the connected account as a billing account.

 

The account ID is now authorized for billing. This is the account that you will add to your space, and it is available in the list of options. Only AWS accounts that have been added to your space will show in the list.

You must have the **Space administrator** role to manage billing and accounts for your space.

**To designate an added AWS account to a CodeCatalyst space for billing**

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigate to your CodeCatalyst space. Choose **Settings**, and then choose **Billing**.

   The **Billing details** page displays.

1. Choose **Add an AWS account**.

   If the space already has a designated billing account that you want to change, choose the **Edit** button next to the **AWS account name** field. 

   The **Change AWS billing account** page displays.

1. From the **Choose from AWS accounts already associated with your space** dropdown menu, choose the name of another added account for your space that you want to designate as the billing account for your CodeCatalyst space. The account name must be for an account that has been added to your space with a connection and is listed in the **AWS accounts list for your space**.

1. Choose **Change billing account**.

# Changing allowed tiers for a billing account
<a name="managing-billing-turn-on-tier"></a>

When you set up a billing account, the allowed CodeCatalyst tiers that you want to allow your space to use defaults to the free and paid tiers. You can turn the paid tiers on or off from your space's **Settings**. 

You must have the **Space administrator** role in CodeCatalyst and have administrator permissions for your account in AWS to manage billing.

1. In the AWS Management Console, make sure you are signed in with the same account that you want to manage. You will be automatically directed to a page in the AWS Management Console from the CodeCatalyst console.

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigate to your CodeCatalyst space. Choose **Settings**, and then choose **Billing**.

   The **Billing details** page displays.

1. Choose **Manage billing in AWS**. This opens the Amazon CodeCatalyst Spaces in the AWS Management Console. If you are prompted to sign in, sign in to AWS, and then choose the button again to load the page.

1. Choose **Spaces**. The list of each space with a connection to the account you are signed in with, if any, displays.

1. Choose the account link for your CodeCatalyst space. The connection page is shown.

1. Under **Billing details**, choose **Edit**. The **Update allowed billing tiers** page displays.

1. To keep the default, leave the selection on **PAID (STANDARD, ENTERPRISE)**. To turn off paid tiers, deselect the **PAID (STANDARD, ENTERPRISE)** field.

1. Choose **Update**.

# Changing your CodeCatalyst billing tier
<a name="managing-billing-change-plan"></a>

When you set up a billing account, the allowed CodeCatalyst tiers that you want to allow your space to use defaults to the free and paid tiers. Your current plan and configuration for billing, if set up, is available in the CodeCatalyst console. 

You must have the **Space administrator** role in CodeCatalyst and have administrator permissions for your account in AWS to manage billing.

**To change your CodeCatalyst billing tier**

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigate to your CodeCatalyst space. Choose **Settings**, and then choose **Billing**.

   The **Billing details** page displays.

1. Choose **Change billing tier**. The **Compare tiers** page displays with available plans and the list of charges that apply to each plan. 

   On the **Tiers** page, choose the tier with the charges that you want to authorize your CodeCatalyst space to use. The following tiers are available:
   + **Free**
   + **Standard**
   + **Enterprise**

   For the Enterprise tier, you can enter a value in the **Number of team members** input field to view the total amount of each resource included in your space.

1. Review the details for the change, and then choose **Change tier**.

# Changing a billing account
<a name="managing-billing-change-account"></a>

You can change the AWS account that you want to specify as the billing account for your CodeCatalyst space.

**Important**  
You cannot delete the connection for an account that is designated as the billing account for your space.

You must have the **Space administrator** role to manage billing and accounts for your space.

**To change the AWS account for a CodeCatalyst space for billing**

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigate to your CodeCatalyst space. Choose **Settings**, and then choose **Billing**.

   The **Billing details** page displays.

1. Choose the **Edit** button next to the **AWS account name** field. The **Change AWS billing account** page displays.

1. In **Choose from AWS accounts already associated with your space**, choose the name of another added account that you want to designate as the billing account for your CodeCatalyst space. The account name must be for an account that has been added to your space and is listed in the **AWS accounts** tab for your space.

1. Choose **Change billing account**.

# Viewing your CodeCatalyst plan and billing
<a name="managing-billing-view-plan"></a>

When you set up a billing account, the allowed CodeCatalyst tiers that you want to allow your space to use defaults to the free and paid tiers. Your current subscription tier and the configured billing account are available in the CodeCatalyst console.

You must have the **Space administrator** role in CodeCatalyst to access billing information.

**To access the CodeCatalyst billing information**

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigate to your CodeCatalyst space. Choose **Settings**, and then choose **Billing**.

   The **Billing details** page displays.

1. On the **Billing details** page, view your current subscription and usage. In **AWS account status** and **AWS account name**, view the configured AWS account for billing.

**To view the CodeCatalyst billing status**

1. In the AWS Management Console, make sure you are signed in with the same account that you want to manage. You will be automatically directed to a page in the AWS Management Console from the CodeCatalyst console.

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigate to your CodeCatalyst space. Choose **Settings**, and then choose **Billing**.

   The **Billing details** page displays.

1. Choose **Manage billing in AWS**. You are directed to the connections page. 

   You can view details about the connection between your AWS account and CodeCatalyst space. Under **Billing details**, view the CodeCatalyst subscriptions allowed for the account. 

# Viewing CodeCatalyst accounts for billing in AWS
<a name="managing-billing-view-connections"></a>

The Amazon CodeCatalyst page in the AWS Management Consoleshows the account name that you have specified for billing. This page also shows the account connections.

You must have the **Space administrator** role in CodeCatalyst and have administrator permissions for your account in AWS to manage billing.

**To view the CodeCatalyst billing status page for an added account**

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigate to your CodeCatalyst space. Choose **Settings**, and then choose **Billing**.

   The **Billing details** page displays.

1. In **AWS account status**, view the billing status for the account. In **AWS account name**, view the account name, such as `my-space-billing-account`.

**To view CodeCatalyst connections and billing in AWS**

1. In the AWS Management Console, make sure you are signed in with the same account that you want to manage. You will be automatically directed to a page in the AWS Management Console from the CodeCatalyst console.

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigate to your CodeCatalyst space. Choose **Settings**, and then choose **Billing**.

   The **Billing details** page displays.

1. Choose **Manage billing in AWS**. The Amazon CodeCatalyst spaces page in the AWS Management Console displays.
**Note**  
You might need to sign in to AWS before you can open the page in the AWS Management Console.

# Getting AWS billing information
<a name="managing-billing-information"></a>

If you have the necessary permissions, you can get information about your AWS charges from the AWS Management Console.

For more information about billing, including information about the tiers available, rates, and information included in the monthly AWS billing cycle, see the [Amazon CodeCatalyst pricing page](https://codecatalyst.aws/explore/pricing).

**To get your billing information**

1. Sign in to the AWS Management Console and navigate to **Billing**. In the navigation bar, choose your account name.

1. Choose **Billing dashboard**.

1. Use the AWS Billing and Cost Management dashboard to find a summary and a breakdown of your monthly spending. To learn more, see the [AWS Billing User Guide](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/).

# Troubleshooting problems with billing associated with your space
<a name="troubleshooting-billing"></a>

In CodeCatalyst, you can add an AWS account to your space to grant permissions to resources and for billing purposes. The following information can help you troubleshoot common issues with associated accounts in CodeCatalyst.

**Topics**
+ [

## I cannot access the Amazon CodeCatalyst Spaces page in the AWS Management Console
](#billing-troubleshoot-console)
+ [

## I cannot change the billing tier for my space
](#billing-troubleshoot-need-associated-account)

## I cannot access the Amazon CodeCatalyst Spaces page in the AWS Management Console
<a name="billing-troubleshoot-console"></a>

**Problem:** When I try to access the Amazon CodeCatalyst page in the AWS Management Console to add an account to my CodeCatalyst space or add roles to an account in AWS, I receive a permissions error.

**Possible fixes:**

For your space, you can add authorized AWS accounts to add them to your project if you have the **Space administrator** role. You must also have an AWS account where you have administrative permissions or can work with your AWS administrator. You must first make sure you are signed in to the AWS Management Console with the same account that you want to manage. After you are signed in to the AWS Management Console, you can open the console and try again.

Open the Amazon CodeCatalyst page in the AWS Management Console at [https://us-west-2.console.aws.amazon.com/codecatalyst/home?region=us-west-2\$1/](https://us-west-2.console.aws.amazon.com/codecatalyst/home?region=us-west-2#/).

## I cannot change the billing tier for my space
<a name="billing-troubleshoot-need-associated-account"></a>

**Problem:** I am able to view billing for my space but cannot change the subscription tier from Free to Standard.

**Possible fixes:** For your space, you can change subscription tiers or authorize billing accounts if you have the **Space administrator** role. 

Before you can change your CodeCatalyst plan from the Free tier, you must first have an account added to your space. Next, you must set up the account for billing by turning on the Standard tier.

This does not change the billing tier for the space. It authorizes the Standard tier for the account, so the **Space administrator** will be able to upgrade to the Standard tier.

You must have the **Space administrator** role in CodeCatalyst and have administrator permissions for your account in AWS to manage billing.