How do I delete an application in AWS Amplify?
I want to delete my application in AWS Amplify, including all of the application's backend resources. How can I delete an Amplify application?
Short description
To delete an Amplify application, it's a best practice to use one of the following:
-
Amplify console
-
Amplify Command Line Interface (Amplify CLI)
If your application isn't deleted after using either of these methods, use the AWS Command Line Interface (AWS CLI) as a workaround.
Note:
The AWS CloudFormation stack is deleted first. Then, any associated Amazon Simple Storage Service (Amazon S3) buckets are deleted. The application is deleted from the Amplify console last. The CloudFormation stack deletes all of the application's associated backend resources, except the Amazon S3 buckets. The time that it takes to delete an application from Amplify depends on the size of the application's backend resources.
Resolution
Important:
When you delete an Amplify application, all of the application's backend resources are also deleted. You can't recover your Amplify application's resources after they're deleted.
To delete an Amplify application using the Amplify console
1. Open the AWS Amplify console.
2. In the left navigation pane, choose the name of the application that you want to delete. The
App
page opens.
3. On the
App
page, select the
Actions
dropdown list. Then, choose
Delete app
.
To delete an Amplify application using the Amplify CLI
If you haven't already done so, install the Amplify CLI. Then, do one of the following, based on whether your project is locally accessible or cloud based.
For locally accessible projects
Within the project directory that you want to delete, run the following amplify delete command:
For cloud-based projects
1. Pull the backend environment associated with your application to your local environment by running the following amplify pull command:
2. Within the project directory that you want to delete, run the following
amplify delete
command:
3. (For applications with multiple backend environments) Repeat steps 1 and 2 for each of your application's backend environments.
Note:
Deleting an Amplify application using the Amplify console or Amplify CLI can fail for many reasons. If you receive an error when trying to delete your application, use the AWS CLI as a workaround to delete the application instead.
To delete an Amplify application using the AWS CLI
Manually delete the project's Amazon S3 buckets and CloudFormation stack from the AWS Management Console
1. Open the Amplify console.
2. In the left navigation pane, choose the name of the application that you want to delete. The
App
page opens.
3. Copy and save the
App ID
value and the backend environment's name. You need these values to delete the application using the AWS CLI.
4. Delete the CloudFormation stack's Amazon S3 deployment bucket. For instructions, see Deleting a bucket in the Amazon S3 User Guide.
Note:
The CloudFormation stack's S3 deployment bucket name is listed in the following format:
amplify-<application-name>-<backend-environment-name>-<random-number>-deployment
5. (If your project uses the Amplify Storage category) Delete the project's storage S3 bucket.
Note:
The storage bucket name is listed in the project's root stack resources, under the
Storage
nested stack.
6. Delete the project's CloudFormation root stack. For instructions, see Deleting a stack on the AWS CloudFormation console in the CloudFormation User Guide.
Note:
The CloudFormation stack's root stack name is listed in the following format:
amplify-<application-name>-<backend-environment-name>-<random-number>
7. (For applications with multiple backend environments) Repeat steps 4-6 for each of your application's backend environments.
Delete the Amplify application using the AWS CLI
Note:
If you receive errors when running AWS CLI commands, make sure that you're using the most recent version of the AWS CLI.
Run the following delete-app AWS CLI command:
Important:
Replace
your-app-id
with your application's App ID. Replace
application-region
with the AWS Region that your application is in.
aws amplify delete-app --app-id <your-app-id> --region <application-region>
Note:
You can also run the delete-backend-environment command to delete all of your application's backend environments first. Then, delete your application from the Amplify console.
Submit feedback
Do you need billing or technical support?
Contact AWS Support