# Managing AMI-based products as an AWS Marketplace seller
As an AWS Marketplace seller, you can manage and update your single [Amazon Machine Images (AMIs)](https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html#AmazonMachineImage) products. AMI-based products include a set of one or more versions of the software and metadata about the product as a whole. When you create the product, you configure its properties in AWS Marketplace, including your product name, description, and pricing. You also determine the appropriate categories for your product and add keywords so your product appears in relevant searches. After you create, your single-AMI product, you can submit change requests to make changes to your product or version.
The types of changes you can request for AMI-based products include:
+ Update product information displayed to buyers.
+ Update version information displayed to buyers.
+ Add a new version of your product.
+ Restrict a version so that new buyers can no longer access that version.
+ Update the AWS Regions that a product is available in.
+ Update the pricing and instance types for a product.
+ Remove a product from AWS Marketplace.
The following topics show to manage and update a single AMI product.
**Topics**
+ [
# Creating a change request for an AMI-based product in AWS Marketplace
](single-ami-create-change-request.md)
+ [
# Updating AMI-based product visibility
](ami-update-visibility.md)
+ [
# Adding and restricting AMI instances for AWS Marketplace
](single-ami-instance-types.md)
+ [
# Managing versions for AMI-based products on AWS Marketplace
](single-ami-versions.md)
+ [
# Updating AMI-based product information on AWS Marketplace
](single-ami-updating-product.md)
+ [
# Managing AMI-based product availability by AWS Region and country
](single-ami-regions.md)
+ [
# Updating end user license agreement (EULA) for your AMI-based AWS Marketplace product
](single-ami-update-eula.md)
+ [
# Updating the refund policy for your AMI-based product on AWS Marketplace
](single-ami-update-refund-policy.md)
+ [
# Giving AWS Marketplace access to your AMI
](single-ami-marketplace-ami-access.md)
+ [
# Removing a product from AWS Marketplace
](removing-products-from-aws-marketplace.md)
+ [
# Troubleshooting common errors for change requests on AWS Marketplace
](request-errors-and-issues.md)
# Creating a change request for an AMI-based product in AWS Marketplace
To make changes to a product or version in AWS Marketplace, you submit a **change request** through the AWS Marketplace Management Portal. Change requests are added to a queue and can take from minutes to days to resolve, depending on the type of request. You can see the status of requests in the AWS Marketplace Management Portal. This topic provides the procedures that you can use to create a change request for a single-AMI product in AWS Marketplace, including the option to use the self-service experience.
You can create a change request for the following situations:
+ You saved your in-progress steps, but didn't complete the entire process, while using the self-service experience to create a single-AMI product listing. To complete the remaining steps, you create a change request.
+ You want to make modifications to the product information for your product that is in either a **Limited** or **Public** state. To update the information, you create a change request. For more information about the types of changes that you can request for AMI-based products, see [Create a change request](#single-ami-creating-change-request).
**Note**
In addition to the AWS Marketplace Management Portal, you can also create change requests by using the [AWS Marketplace Catalog API](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/seller-products.html).
**Topics**
+ [
## Create a change request by using self-service
](#ami-self-service-change-req)
+ [
## Create a change request
](#single-ami-creating-change-request)
+ [
## Get the status of a change request
](#single-ami-getting-change-request-status)
+ [
## Additional resources
](#ami-single-change-req-resources)
## Create a change request by using self-service
To make modifications to versions or the product information, you create a *change request* in the AWS Marketplace Management Portal. Change requests are the building blocks of a self-service listing that you use to make changes to your product. Each time you select **Save and exit** from the steps or select **Submit** for any update, you are making a change request. You can find your requests on the AWS Marketplace Management Portal [Request ](https://aws.amazon.com/marketplace/management/requests) tab.
**To create a change request using self-service**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and sign in to your seller account, then go to the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page.
1. On the **Server products** tab, select the product that you want to modify.
1. Choose an option from the **Request changes** dropdown.
1. After you make a change request, there is a wait time for the system to process your request, reflected **Under Review**. When the request completes, it will result in either **Succeeded** or **Failed**.
+ After the request is submitted, it begins processing through these statuses: **Under review**, **Preparing changes**, and **Applying changes**.
+ **Succeeded** means that the requested change has been processed and changes reflect in the system.
+ **Failed** means that something went wrong with the request, so the changes were not processed. If the status is **Failed**, you can select the request to find error codes that provide recommendations on how to correct the error. At this point, you can troubleshoot the errors and create a new request for the change. To make the process faster, you can choose **Copy to new request ** to copy the details of the failed request. Then, you can make the adjustment and resubmit the request.
## Create a change request
**Important**
On June 15, 2023, AWS Marketplace will discontinue the following procedure. After June 15, 2023, use the [Create a change request by using self-service](#ami-self-service-change-req) procedure.
To make modifications to versions or the product information, you create a *change request* in the AWS Marketplace Management Portal.
**To create a change request**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and sign in to your seller account, then go to the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page.
1. On the **Server products** tab, select the product that you want to modify.
1. Choose an option from the **Request changes** dropdown list.
For most change requests, you simply fill out the form in the user interface and submit it. However, for certain changes, you must download, complete, and then upload a Product Load Form (PLF). This is a spreadsheet that contains a form for you to fill out with the required information. When you choose one of these change requests, you are prompted to download the correct PLF for the request you are attempting to create. The PLF is pre-populated with information from your existing product details. You can upload your completed PLF to the AWS Marketplace Management Portal [ File upload](https://aws.amazon.com/marketplace/management/product-load) page.
**Note**
We strongly recommend that you download and use the most recent PLF. The form is regularly updated with new information, including instance types and AWS Regions as they become available. You can find the latest PLF for a product from the **Server products** page, by selecting the product and then choosing **Download Product Load Form**.
For more information about the status of a change request, see [Get the status of a change request](#single-ami-getting-change-request-status). For insight into potential issues with change requests, see [Troubleshooting common errors for change requests on AWS Marketplace](request-errors-and-issues.md).
## Get the status of a change request
**Important**
On June 15, 2023, AWS Marketplace will discontinue the following procedure. This procedure is no longer needed for the self-service experience.
After you submit a change request, you can see the status of your request from the **Requests** tab of the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page of the AWS Marketplace Management Portal. The status could be any of the following:
+ **Under review** means that your request is being reviewed. Some requests require manual review by the AWS Marketplace team but most are reviewed automatically in the system.
+ **Succeeded** means that your request is complete. Your product or version has been updated as you requested.
+ **Action required** means that you need to update your request to fix an issue or answer a question about the request. Select the request to see the details, including any issues.
+ **Failed** means that something went wrong with the request, and you should create a new request for the change, with the same data.
## Additional resources
For more details about change requests for specific types of updates, see the following resources:
+ [Updating AMI-based product information on AWS Marketplace](single-ami-updating-product.md)
+ [Update version information](single-ami-versions.md#single-ami-updating-version)
+ [Add a new version](single-ami-versions.md#single-ami-adding-version)
+ [Restrict a version](single-ami-versions.md#single-ami-restricting-version)
# Updating AMI-based product visibility
As an AWS Marketplace seller, you can update your product visibility to change which buyers can view your single AMI product in AWS Marketplace. If the visibility status is set to **Public**, your product is visible to all AWS Marketplace buyers. If your product visibility is set to **Limited**, your product is visible only to the AWS account IDs that you allowlist. You can also manage and update this allowlist of AWS account IDs that can see your product. The following sections show you how to update your product visibility and **Limited** visibility allowlist.
**Topics**
+ [
## Update product visibility
](#ami-update-self-service-visibility)
+ [
## Update the allowlist (preview accounts)
](#single-ami-updating-allowlist)
## Update product visibility
To change which buyers can view your product in AWS Marketplace, you can use **Update visibility**.
**To update visibility**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and then sign in to your seller account.
1. Go to the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page, on the **Current server product** tab, select the product that you want to modify.
1. From the **Request changes** dropdown, choose **Update visibility**.
**Note**
You can request that the product be moved from a **Limited** status to a **Public** status by using this change request. However, the change request must go through an AWS Marketplace Seller Operations team approval process to be moved to **Public**.
1. Choose **Submit change request** to submit your request for review.
1. Verify that the **Requests** tab shows the **Request status** as **Under review**. When the request completes, the status becomes **Succeeded**.
## Update the allowlist (preview accounts)
To change the list of AWS account IDs that can see your product in a **Limited** state, use **Update allowlist**.
**To update the allowlist**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and then sign in to your seller account.
1. Go to the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page, and on the **Current server product** tab, select the product that you want to modify.
1. From the **Request changes** dropdown, choose **Update allowlist**. The current list is provided with the list of accounts that are currently allowlisted.
1. Add the AWS account IDs that are preferred for visibility and separate the IDs with commas.
1. Choose **Submit change request** to submit your request for review.
1. Verify that the **Requests** tab shows the **Request status** as **Under review**. When the request completes, the status becomes **Succeeded**.
# Adding and restricting AMI instances for AWS Marketplace
As an AWS Marketplace seller, you can manage which instances buyers can use for your single Amazon Machine Imagine (AMI) product. You can add a new instance for your single AMI product that buyers can use. Similarly, if you want to prevent new buyers from using your single AMI product from a specific instance, you can restrict the instance.
For more information about the Amazon EC2 instance types, see [Available instance types](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes) in the *Amazon EC2 User Guide*.
The following sections explain how to add and restrict instances.
**Topics**
+ [
## Adding an instance
](#single-ami-adding-instance-types)
+ [
## Restricting an instance
](#single-ami-restricting-instance-types)
## Adding an instance
You can add a new instance which buyers can use as a single-AMI.
**To add an instance**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and then sign in to your seller account.
1. Go to the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page, and on the **Current server product** tab, select the product that you want to modify.
1. From the **Request changes** dropdown, choose **Add instance**.
1. Select an instance architecture.
1. Select the instance types that you want to add from the list of available instances.
1. Choose **Submit request** to submit your request for review.
1. Verify that the **Requests** tab shows the **Request status** as **Under review**. When the request completes, the status becomes **Succeeded**.
**Note**
If your current pricing model is not free or uses a Bring Your Own License (BYOL) model, you must also add prices.
If you created an **Add instance** with a price for the new instance or **Update pricing** to increase a price, you can’t use self-service to **Add instance** in the 90 days starting from the day you made the change. To make these changes, contact the [AWS Marketplace Seller Operations team](https://aws.amazon.com/marketplace/management/contact-us/).
When you add support for a new instance type, customers already subscribed to private offers for your product won't be able to launch the newly added instance automatically. You must create another private offer with the instance you want customers to access. After accepting the new offer, customers can launch the newly added instance. Customers who subscribe to your product at a future date can also launch the instance, as long as the instance is included in the private offer. For more information about how to create a new private offer, see [Amending agreements in AWS Marketplace](private-offers-upgrades-and-renewals.md) later in this guide.
**Note**
**FPGA Instance Type Support**
Products with AFI IDs support F2 instance types only. You can offer your AMI on other instance types, however, the AFIs will not be loaded on other instance types. When buyers launch your product on non-F2 instances, the AMI will function without the FPGA acceleration capabilities provided by the AFI IDs.
## Restricting an instance
To prevent new buyers from using an instance of an AMI product, you can restrict the instance. You can add the instance back at a later time, if needed. Existing users of the single AMI on the restricted instance can continue to use the product from the Region for the length of their subscriptions.
**To restrict an instance**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and then sign in to your seller account.
1. Go to the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page, and on the **Current server product** tab, select the product that you want to modify.
1. From the **Request changes** dropdown, choose **Restrict instance**.
1. Select the instances that you want to restrict, and choose **Restrict**.
1. Choose **Submit change request** to submit your request for review.
1. Verify that the **Requests** tab shows the **Request status** as **Under review**. When the request completes, the status becomes **Succeeded**.
**Note**
If the check box is shaded, this means the instance is associated with one to several versions as a recommended instance type. To restrict such instances, use **Update versions** to choose a different recommended instance type. After the change requests complete and the instance you want to restrict is no longer a recommended instance type, you can return to **Restrict instance** to restrict your chosen instance.
# Managing versions for AMI-based products on AWS Marketplace
When you create an Amazon Machine Image (AMI) based product on AWS Marketplace, you include a specific version of your software. The lifecycle of an AMI-based product for AWS Marketplace doesn't end after you publish the first version. You should keep your product up-to-date with new versions of your software. The following sections show you how to manage your versions, which includes updating version information (such as descriptions and dates), adding new versions, and restricting access to previous versions.
**Topics**
+ [
## Update version information
](#single-ami-updating-version)
+ [
## Add a new version
](#single-ami-adding-version)
+ [
## Restrict a version
](#single-ami-restricting-version)
## Update version information
After a version is created, it can be helpful to provide updated information to your buyers by modifying the information associated with the version. For example, if you plan to restrict version 1.0 after version 1.1 is released, you can update the description of version 1.0 to direct buyers to version 1.1, with the date that the version will be restricted. You update the version information from the AWS Marketplace Management Portal.
**To update version information**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and then sign in to your seller account.
1. Go to the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page, on the **Server products** tab, then select the product that you want to modify.
1. From the **Request changes** dropdown, choose **Update version information**.
1. On the **Update version** page, select the version that you want to update.
1. Update any of the following information that you need to modify:
+ **Release notes**
+ **Usage instructions**
+ **64-bit (x86) Amazon Machine Image (AMI)** – Details on usage and security group
1. Select **Submit**.
1. Verify that the request appears on the **Requests** tab with the **Under review** status.
**Note**
You can't use this procedure to update the version title, or the AMI associated with the version. Instead, [create a new version](#single-ami-adding-version) and [restrict the previous version](#single-ami-restricting-version).
You can check the status of your request at any time from the **Requests** tab of the [ Server Products](https://aws.amazon.com/marketplace/management/products/server) page. For more information, see [Get the status of a change request](single-ami-create-change-request.md#single-ami-getting-change-request-status).
## Add a new version
You can add a new version of your product when you make changes to the product, the base image, or any other time you need to modify the AMI for the product. Add a new version of your product from the AWS Marketplace Management Portal.
**Note**
For information about creating an AMI for AWS Marketplace, see [Best practices for building AMIs for use with AWS Marketplace](best-practices-for-building-your-amis.md).
**To add a new version**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and then sign in to your seller account.
1. Go to the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page, on the **Current server product** tab, then select the product that you want to modify.
1. From the **Request changes** dropdown, choose **Add new version**. The **Add a new version** form appears, populated with the information from your most recent version.
**Note**
You can also choose **Test 'Add version'** to scan your AMI and CloudFormation template(s) without adding a new version. For more information, refer to [ Scanning your AMI for publishing requirements ](https://docs.aws.amazon.com/marketplace/latest/userguide/best-practices-for-building-your-amis.html#self-service-scanning) .
1. In the **Version information** section, provide the following information:
+ **Version title** – Enter a valid string (for example *1.1* or *Version 2.0*). It must be unique across the product.
+ **Release notes** – Enter text to describe details about this version.
1. In the **Delivery options** section, select how the buyer can deploy the solution, either AMI (standalone), AMI with CloudFormation, or both. You can choose up to three AMI with CloudFormation delivery options.
**Note**
New delivery options can't be added to an existing version. All delivery options for a single version must be submitted in the same request.
1. In the **Amazon Machine Image (AMI)** section, provide the following information:
+ **Amazon Machine Image ID** – Enter the AMI ID for the AMI that you want to use for this version. You can find the AMI ID from the [ list of AMIs in the console](https://console.aws.amazon.com/ec2/v2/home?region=us-east-1#Images:sort=name). The AMI must exist in the US East (N. Virginia) Region, and in your AWS Marketplace Seller account. The snapshot associated with this AMI can't be encrypted.
+ **IAM access role ARN** – Enter the Amazon Resource Name (ARN) for an AWS Identity and Access Management (IAM) role that allows AWS Marketplace to gain access to your AMI. For instructions on how to create the IAM role, see [Giving AWS Marketplace access to your AMI](single-ami-marketplace-ami-access.md). Use the standard format for an IAM ARN, for example: *arn:aws:iam::123456789012:role/RoleName*. The ARN must exist in your AWS Marketplace Seller account.
+ **Operating system (OS)** – Enter the base operating system for your AMI.
+ **OS version** – Enter which version of the operating system that your AMI is using.
+ **OS user name** – For Linux-based AMIs, enter the name of a user that can be used to sign into the instance. We recommend using *ec2-user*.
+ **Scanning port** – Enter the port number that can be used to log into the operating system: the SSH port for a Linux AMI or the RDP port for a Windows AMI.
+ **Amazon FPGA Image (AFI) IDs ** (Optional) – Enter the AFI IDs to associate with your AMI. AFIs only support F2 instance types. You can offer your AMI on other instance types, however, the AFIs will not be loaded in those cases. You can add up to 15 AFI IDs using the **Add AFI ID** button. This option is not available when using CloudFormation templates. All AFI IDs you provide must originate from the US East (N. Virginia) region, reside within your AWS Marketplace seller account, and the provided IAM access role should have permissions to share this AFI with AWS Marketplace.For more details on the required permissions, see [Giving AWS Marketplace access to your FPGA images](https://docs.aws.amazon.com/marketplace/latest/userguide/single-ami-marketplace-ami-access.html#single-ami-marketplace-afi-access).
1. Provide the following configurations for the **AMI delivery option** section, if applicable:
+ **Recommended instance type**– Choose the instance type that buyers get by default.
+ **Usage instructions** – Enter instructions for using the AMI or a link to more information about using the AMI. For example: *To get started with the product, navigate to https://example.com/usage.htm.*
+ **Endpoint URL** – Provide information about how the buyer can access the software after they create an instance. Enter the **Protocol** (*https* or *http*), the **Relative URL** (for example, */index.html*), and the **Port** (for example, *443*) that buyers can use to access your product. (The host name depends on the EC2 instance, so you only need to provide the relative path).
+ **Security group recommendations** – Enter the information for one or more recommendations, including the protocol (*TCP* or *UDP*), range of ports to allow, and list of IPv4 CIDR IPs (in the form *xxx.xxx.xxx.xxx/nn*, for example, *192.0.2.0/24*).
1. Provide the following configuration settings for the **AMI with CloudFormation delivery option**, if applicable:
+ **Delivery option title** – This is a unique name to identify this Single AMI CloudFormation template delivery option.
+ **Short Description** – A brief description of the CloudFormation template.
+ **Long Description** – A detailed description of the CloudFormation template.
+ **Recommended Instance type** – The instance type, buyers get by default.
+ **Usage instructions** – Instructions for using the solution or a link to more information about using the solution.
+ **CloudFormation template link** – The URL to the location of your CloudFormation template in Amazon S3. For nested stacks or templates, provide the entry point, or parent, template. The Amazon S3 bucket that your file resides must be publicly accessible. For more information, see [Add CloudFormation templates to your product](https://docs.aws.amazon.com//marketplace/latest/userguide/cloudformation.html).
+ **AMI parameter name** – Add the name of the parameter in the CloudFormation template that the EC2 instance resources in your template are referencing for their `ImageId` property value. AWS Marketplace replaces the specified parameter with an [AWS Systems Manager Parameter Store ](https://docs.aws.amazon.com//systems-manager/latest/userguide/systems-manager-parameter-store.html)parameter. When buyers deploy your template, that parameter resolves to the AWS Region-specific AMI ID of your published product. For more information, see [Requirements for AMI details](https://docs.aws.amazon.com//marketplace/latest/userguide/cloudformation.html#ami-requirements-sse).
+ **Architecture diagram link** – The URL to the location of your architectural diagram in Amazon S3. The max image file must be 1560x878 or 1560x3120 pixels in size with a 16:9 or 1:2 ratio. The Amazon S3 bucket that your image file resides must be publicly accessible. For diagram requirements, see [Architectural diagram](https://docs.aws.amazon.com//marketplace/latest/userguide/cloudformation.html#topology-diagram).
1. Select **Submit** to submit the request to add your new version.
**Note**
Adding a new version results in a scanning of the AMI. For more information, refer to [ Scanning your AMI for publishing requirements](https://docs.aws.amazon.com/marketplace/latest/userguide/best-practices-for-building-your-amis.html#self-service-scanning).
**Note**
**AFI ID Support in New Versions**
When adding new AMI versions, AFI IDs can be configured if you select the AMI (standalone) delivery method. The same validation rules that apply during product creation also apply when adding new versions, including character restrictions, uniqueness requirements, regional constraints, and account ownership verification. Once a version is created with AFI IDs, those AFI IDs become immutable and cannot be edited later. If you need to modify AFI IDs, you must create a new version with the updated configuration. New versions with AFI IDs can coexist alongside existing versions that also have AFI IDs, allowing you to maintain multiple FPGA configurations across different product versions. During version preparation, AWS Marketplace creates regional AFI clones to ensure your product is available across supported AWS Regions, streamlining the deployment process for your buyers. This process is handled by the AWS Marketplace Seller Operations team and can take longer than other AMI Add Version requests. During this time, your the request will be 'Under Review'.
1. Verify that the request appears on the **Requests** tab with the **Under review** status. If there are errors to fix, the page displays the errors in a table at the top of the page, and the specific fields that need to be updated display in red.
You can check the status of your request at any time from the **Requests** tab of the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page. The new version will be reviewed and, if successful, published as a new public version of your product. If there is an issue, the status might be **Action required**. Select the request to see details, including any issues.
If your request is successful, your existing users receive the following email message. The message notifies them that the new version is available, links to the version's release notes, and suggests that they upgrade to the latest version. As the AWS account root user, you also receive a copy of the email message in the email account that's associated with your AWS account.
```
Greetings from AWS Marketplace,
Thank you for subscribing to
We are writing to inform you that has added a new version to on AWS Marketplace.
As an existing customer, your subscription to the product, any running instances and access to previous versions
are unaffected. However, does recommend you to update to the latest version, /
by visiting .
For additional questions or upgrade information, please contact directly. Click here
to visit the seller’s profile page on AWS Marketplace.
Release notes for /:
Thank you,
The AWS Marketplace Team
https://aws.amazon.com/marketplace
AWS, Inc. is a subsidiary of Amazon.com, Inc. Amazon.com is a registered trademark of Amazon.com, Inc.
This message was produced and distributed by AWS Inc., 410 Terry Ave. North, Seattle, WA 98109-5210
```
## Restrict a version
If you want to prevent buyers from accessing a specific version of your public product, you can restrict that version.
**Note**
All subscribers can use the current version regardless of the restriction status. AWS Marketplace guidelines require that you continue to offer support to existing buyers for 90 days after restricting the version. Your AMI will be marked as deprecated after the version is restricted. For more information, see [Deprecate an AMI](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ami-deprecate.html) in the *Amazon Elastic Compute Cloud User Guide for Windows Instances*.
**To restrict a version**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and then sign in to your seller account.
1. Go to the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page, on the **Current server product** tab, then select the product that you want to modify.
1. From the **Request changes** dropdown, choose **Restrict version**.
1. On the **Restrict version** page, select the version (or versions) that you want to restrict.
1. Select **Submit** to submit your request for review.
1. Verify that the **Requests** tab shows the **Request status** as **Under review**. When the request completes, the status is **Succeeded**.
**Note**
You can't restrict all versions of a product. If you try to restrict the last remaining public version of a product, you will receive an error. To completely remove a product, see [Removing a product from AWS Marketplace](removing-products-from-aws-marketplace.md).
You can check the status of your request at any time from the **Requests** tab of the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page. For more information, see [Get the status of a change request](single-ami-create-change-request.md#single-ami-getting-change-request-status).
**Note**
Restricting a version can take up to 3 days to complete.
If your request is successful, your existing users receive the following email message that notifies them of the version restriction and suggests they use the most recent version available. As the AWS account root user, you also receive a copy of the email message in the email account that's associated with your AWS account.
```
Greetings from AWS Marketplace,
Thank you for subscribing to .
We are writing to inform you that, as of , will no longer offer version(s) "" to new subscribers. Your use and subscription is unaffected for this version(s), however it is recommended that users upgrade to the latest version on AWS Marketplace.
For additional questions or upgrade information, please contact directly. Click here to visit the seller’s profile page on AWS Marketplace.
Thank you,
The AWS Marketplace Team
https://aws.amazon.com/marketplace
AWS, Inc. is a subsidiary of Amazon.com, Inc. Amazon.com is a registered trademark of Amazon.com, Inc. This message was produced and distributed by AWS Inc., 410 Terry Ave. North, Seattle, WA 98109-5210
```
# Updating AMI-based product information on AWS Marketplace
After you create your single Amazon Machine Image (AMI) product, you can change some of the information associated with it in AWS Marketplace. For example, if a new version modifies the description or highlights of the product, you can edit the product information with the new data. You can also update other product information, including product title, SKU description, categories, keywords, and others. For more information, see the following procedure.
**To update product information**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and then sign in to your seller account.
1. Go to the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page, and on the **Server products** tab, select the product that you want to modify.
1. From the **Request changes** dropdown, choose **Update product information**.
1. Update any of the following fields that you need to change:
+ **Product title**
+ **SKU**
+ **Short description**
+ **Long description**
+ **Product logo image URL**
+ **Highlights**
+ **Product categories**
+ **Keywords**
+ **Product video URL**
+ **Resources**
+ **Support information**
**Note**
For details about the logo format, see [Company and product logo requirements](product-submission.md#seller-and-product-logos).
1. Select **Submit**.
1. Verify that the request appears on the **Requests** tab with the **Under review** status. You might need to refresh the page to see the request on the list.
You can check the status of your request at any time from the **Requests** tab of the [ Server Products](https://aws.amazon.com/marketplace/management/products/server) page. For more information, see [Get the status of a change request](single-ami-create-change-request.md#single-ami-getting-change-request-status).
# Managing AMI-based product availability by AWS Region and country
When you create a product in AWS Marketplace, you choose the AWS Regions where it is available. You also choose the countries where buyers can purchase your product from. These two properties are similar, but they are not the same. For example, a buyer might be located in, and purchasing from, the United States, but they might be planning to install your product in the Europe (Frankfurt) Region. In order for this buyer to purchase your product, you must include both the United States in your list of countries, and the Europe (Frankfurt) Region in your list of Regions. You can use the following sections to update your product availability by Region and country.
**Topics**
+ [
## Add an AWS Region
](#single-ami-adding-regions)
+ [
## Restrict an AWS Region
](#single-ami-restricting-regions)
+ [
## Update support for future AWS Regions
](#single-ami-updating-future-region-support)
+ [
## Update availability by country
](#single-ami-update-availability-by-country)
## Add an AWS Region
You can add a Region where buyers can use your product.
**To add a Region**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and then sign in to your seller account.
1. Go to the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page, and on the **Current server product** tab, select the product that you want to modify.
1. From the **Request changes** dropdown, choose **Add Region**.
1. Select the Region that you want to add from the list of available Regions.
1. Choose **Submit request** to submit your request for review.
1. Verify that the **Requests** tab shows the **Request status** as **Under review**. When the request completes, the status becomes **Succeeded**.
**Note**
When you add support for a new AWS Region, customers already subscribed to private offers for your product won't be able to access the newly added Region automatically. You must create another private offer with the Region you want customers to access. After accepting the new offer, customers can access the newly added Region. Customers who subscribe to your product at a future date can also access the Region, as long as the Region is included in the private offer. For more information about how to create a new private offer, see [Private offer upgrades, renewals, and amendments](https://docs.aws.amazon.com/marketplace/latest/userguide/private-offers-upgrades-and-renewals.html).
**Note**
**FPGA Regional Requirements**
When adding regions to FPGA products, regional AFI clones are automatically created by AWS Marketplace to ensure your product is available across supported AWS Regions. This process ensures that buyers can deploy your FPGA-accelerated product in their preferred Region without requiring manual AFI replication. The automatic cloning process maintains consistency across all regions where your product is available.
## Restrict an AWS Region
To prevent new buyers from using your product in a specific AWS Region, you can restrict the Region. You can add the Region back at a later time. Existing subscribers of the product in the Region can continue using the product from the Region as long as they're subscribed.
**To restrict a Region**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and then sign in to your seller account.
1. Go to the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page, and on the **Current server product** tab, select the product that you want to modify.
1. From the **Request changes** dropdown, choose **Restrict Region**.
1. Select the dropdown menu to view the list of Regions in which your product is currently available.
1. Select the Regions that you want to restrict.
1. The Regions you have selected appear as tokens. Review the list of Regions that you're restricting, and enter X for Regions that you don't want to restrict.
1. Choose **Submit change request** to submit your request for review.
1. Verify that the **Requests** tab shows the **Request status** as **Under review**. When the request completes, the status becomes **Succeeded**.
If your request is successful, your existing users receive the following email message notifying them of the Region to be restricted. They can continue using your product as long as they remain subscribed, but they can’t re-subscribe if they cancel the subscription.
```
Greetings from AWS Marketplace,
This message is a notification detailing a recent change for .
{{{sellerName}}} has opted to restrict the product in beginning .
This impacts you in the following ways:
1. As long as you're subscribed to the product, you can continue using the software product in the restricted Region.
2. You can't begin new instances of the software product in the restricted Region.
3. You can continue using the software product in all available AWS Regions.
Regards,
The AWS Marketplace Team
AWS, Inc. is a subsidiary of Amazon.com, Inc. Amazon.com (http://amazon.com/) is a registered
trademark of Amazon.com, Inc. This message was produced and distributed by Amazon Web
Services Inc., 410 Terry Ave. North, Seattle, WA 98109-5210.
```
## Update support for future AWS Regions
If you want your product to be onboarded to newly launched AWS Regions, you can use **Update future Region support**.
**To update future Region support**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and then sign in to your seller account.
1. Go to the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page, and on the **Current server product** tab, select the product that you want to modify.
1. From the **Request changes** dropdown, choose **Update future Region support**.
1. You can choose to activate future Region support to allow AWS Marketplace to onboard your product to newly launched AWS Regions on your behalf.
1. After activating the feature, you can choose between all future Regions or limit to US Regions only.
1. Choose **Submit change request** to submit your request for review.
1. Verify that the **Requests** tab shows the **Request status** as** Under review**. When the request completes, the status becomes **Succeeded**.
## Update availability by country
If you want to change the countries in which your product can be subscribed to and offered, you can use **Update availability**.
**To update availability by country**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and then sign in to your seller account.
1. Go to the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page, on the **Current server product** tab, then select the product that you want to modify.
1. From the **Request changes** dropdown, choose **Update availability**.
1. Choose one of the following options:
1. **All countries** – Available in all supported countries.
1. **All countries with exclusions** – Available in all supported countries except in selected countries.
1. **Custom list** – Specific list of countries where the product is available.
1. Choose **Submit change request** to submit your request for review.
1. Verify that the **Requests** tab shows the **Request status** as **Under review**. When the request completes, the status becomes **Succeeded**.
# Updating end user license agreement (EULA) for your AMI-based AWS Marketplace product
As an AWS Marketplace seller, you can update the end user license agreement (EULA) that will govern the use of your single Amazon Machine Image (AMI) product. Your EULA is located on the product listing page for public software listings on AWS Marketplace. You can either apply your own EULA or use the [Standard Contract for AWS Marketplace (SCMP)](standardized-license-terms.md). The following procedure shows you how to update the EULA for your single-AMI product.
For more information about the EULA, see [Using standardized contracts in AWS Marketplace](standardized-license-terms.md).
**To update a EULA**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and then sign in to your seller account.
1. Choose the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) tab, on the **Current server product** tab, select the product that you want to modify.
1. From the **Request changes** dropdown, choose **Update end-user license agreement**.
1. You can select the [Standard Contract for AWS Marketplace (SCMP) ](https://docs.aws.amazon.com/marketplace/latest/userguide/standardized-license-terms.html) or submit your own custom EULA. For a custom EULA, you must provide the URL for your custom contract from an Amazon S3 bucket.
**Note**
Public accessibility must be enabled on your Amazon S3 bucket.
1. Choose **Submit change request** to submit your request for review.
1. Verify that the **Requests** tab shows the **Request status** as **Under review**. When the request completes, the status becomes **Succeeded**.
# Updating the refund policy for your AMI-based product on AWS Marketplace
As an AWS Marketplace seller, you can set the refund policy for your single Amazon Machine Image (AMI) product. If you want to change the refund policy for your product, you can use **Update refund policy**. The following procedure shows you how to update your refund policy.
**To update the refund policy**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and then sign in to your seller account.
1. Go to the [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) page, on the **Current server product** tab, then select the product that you want to modify.
1. From the **Request changes** dropdown, choose **Update refund policy**.
1. The current refund policy details are provided in the text box for you to edit. Submitting the request overwrites the current refund policy.
1. Choose **Submit change request** to submit your request for review.
1. Verify that the **Requests** tab shows the **Request status** as **Under review**. When the request completes, the status becomes **Succeeded**.
# Giving AWS Marketplace access to your AMI
When you create a request that includes adding a new Amazon Machine Image (AMI) to AWS Marketplace, the AMI must be copied into the AWS Marketplace system and then scanned for security issues. You must give AWS Marketplace access to the AMI by creating an AWS Identity and Access Management (IAM) role with permissions to perform actions on your AMI and a trust policy that allows AWS Marketplace to assume the role. You only need to create the IAM role once. The following procedure shows you how to create a role for AWS Marketplace assets ingestion that gives AWS Marketplace access to your AMI.
**To create a role for AWS Marketplace AMI assets ingestion**
1. Sign in to the AWS Management Console, open the IAM console and go to the [Roles page](https://console.aws.amazon.com/iam/home?region=us-east-1#/roles).
1. Select **Create role**.
1. On the **Create role** page, make the following selections:
+ **Select type of trusted entity** – Choose **AWS Service**.
+ **Choose a use case** – Choose **AWS Marketplace**.
+ **Select your use case** – Choose **Marketplace – AMI Assets Ingestion**.
+ To move to the next page, select **Next: Permissions**.
1. Select the **AWSMarketplaceAmiIngestion** policy. Add a permissions boundary if required, and then select **Next: Tags** to continue.
**Note**
You can use permissions boundaries to limit the access that you give AWS Marketplace with this role. For more information, see [Permissions boundaries for IAM entities](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html) in the *AWS Identity and Access Management User Guide*.
1. To continue, select **Next: Review**.
1. Provide a name for the role, and select **Create role**.
1. You should see "The role *rolename* has been created" at the top of the page, and the role should appear in the list of roles.
On this page, when you select the role that you just created, you can see its ARN in the form *arn:aws:iam::123456789012:role/exampleRole*. Use the ARN for the **IAM access role ARN** when you create change requests, for example, when [adding a new version](single-ami-versions.md#single-ami-adding-version) to your product.
## Giving AWS Marketplace access to your FPGA images
If your AMI includes FPGA images (AFIs), you must also grant AWS Marketplace additional permissions to access and manage these FPGA images. In addition to the **AWSMarketplaceAmiIngestion** policy, you need to create an inline policy that allows AWS Marketplace to perform actions on your FPGA images.
**To add FPGA image permissions to your AWS Marketplace AMI assets ingestion role**
1. Sign in to the AWS Management Console, open the IAM console and go to the [Roles page](https://console.aws.amazon.com/iam/home?region=us-east-1#/roles).
1. Select the role that you created for AWS Marketplace AMI assets ingestion.
1. On the role details page, select the **Permissions** tab, and then select **Add inline policy**.
1. Select the **JSON** tab and enter the following policy:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action":[
"ec2:DescribeFpgaImages",
"ec2:DescribeFpgaImageAttribute",
"ec2:CopyFpgaImage",
"ec2:ModifyFpgaImageAttribute"
],
"Resource":"*"
}
]
}
```
------
1. Select **Review policy**.
1. Provide a name for the policy, such as **AWSMarketplaceAfiIngestion**, and then select **Create policy**.
After you add this inline policy, AWS Marketplace will have the necessary permissions to access and manage your FPGA images during the ingestion and scanning process.
# Removing a product from AWS Marketplace
After you publish your product, you can remove it from AWS Marketplace. This is also referred to as *sunsetting*. To remove a product, identify the product and submit a request to remove it, along with a reason for removal and a contact email address for you. You can also provide a replacement product ID if you're replacing the current product with a new one.
After you request product removal, new customers can't subscribe to the product. You must support any existing customers for a minimum of 90 days.
**Note**
You can't delete restricted products from the AWS Marketplace Management Portal. The portal retains them as part of the account's publication history.
We process requests for product removal from AWS Marketplace with the following conditions:
+ The product is removed from AWS Marketplace search, browse, and other discovery tools. Any **Subscribe** button or functionality is disabled, and messaging on the page clearly indicates the product is no longer available. The product detail page is still accessible using the URL and might be indexed in public search engines.
+ A reason for removal must be specified (for example, end of support, end of product updates, or replacement product). For the requirements for continuing support for removed products, see [ Terms and Conditions for AWS Marketplace Sellers](https://aws.amazon.com/marketplace/management/terms).
+ AWS Marketplace contacts current buyers through an email message informing them of the product removal, reasons for the removal, and to provide seller contact information.
+ Current buyers *do* retain access to the software until they cancel their subscription. They aren't affected in any way by the product's removal.
**To remove a product created using the AWS Marketplace Management Portal**
1. Open the AWS Marketplace Management Portal at [https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), and then sign in to your seller account.
1. Choose the **Products** tab, and then choose **Server**.
1. On your product page, under **Server products**, locate the product that you want to remove. From the **Request changes** dropdown list, choose **Update product visibility**.
1. On the **Update product visibility** page, select **Restricted**.
1. (Optional) Provide a **Replacement Product ID**, if there is another product that will take the place of the product you are removing.
1. Review the information for accuracy, and then choose **Submit**.
A **What’s next** informational page displays after you submit the product removal request. The AWS Marketplace Seller Operations reviews and processes your request. Check the status of your submission by viewing **Requests**.
After your product is removed, the product appears in the **Current Products** list in the AWS Marketplace Management Portal. In **Current Products**, the only action that you can perform is downloading the spreadsheet for the product. You can't edit or submit another sunset request.
If you have questions about product removals, contact the [AWS Marketplace Seller Operations](https://aws.amazon.com/marketplace/management/contact-us/) team.
# Troubleshooting common errors for change requests on AWS Marketplace
When you make changes to your product's information on AWS Marketplace, you might run into errors. This topic explains some common errors and provides suggestions for how to fix them.
+ **Scanning your AMI** – Several issues could happen when scanning your AMI:
+ You have not granted AWS Marketplace permissions to scan your AMI. Grant AWS Marketplace permissions to access it. Or you have granted permissions, but the permissions boundary is too restrictive. For more information, see [Giving AWS Marketplace access to your AMI](single-ami-marketplace-ami-access.md).
+ If scanning finds security issues or Common Vulnerabilities and Exposures (CVEs) in your AMI, make sure you're using the latest patches for the operating system in your image. For more information, see [AMI-based product requirements for AWS Marketplace](product-and-ami-policies.md).
For general guidelines about building an AMI, see [Best practices for building AMIs for use with AWS Marketplace](best-practices-for-building-your-amis.md).
+ **AWS Marketplace Management Portal fields** – Some fields in the AWS Marketplace Management Portal require very specific information:
+ If you are unsure about what the field is requesting, try checking the details in the console. Most fields have text descriptions above the field, and formatting requirements below the field.
+ If you try to submit a form with one or more invalid fields, a list of issues is shown. A recommended action is provided to help you fix the issue.
+ If you're asked to provide an ARN, you will typically find it elsewhere in the console. For example, the ARN for the IAM role that you created to give AWS Marketplace access to your AMI is found on the [ Roles page](https://console.aws.amazon.com/iam/home?region=us-east-1#/roles) in the IAM console. ARNs all have a similar format. For example, an IAM role ARN is in the form *arn:aws:iam::123456789012:role/exampleRole*.
+ Your logos and videos must be provided as a URL directly to the content. For more information about logo formats, see [Company and product logo requirements](product-submission.md#seller-and-product-logos).
For more information about submitting products and version change requests, see [Submitting your product for publication on AWS Marketplace](product-submission.md).
+ **Product Load Form (PLF) issues** – PLFs contain instructions that are included in the spreadsheet. Overall instructions are provided in the Instructions table. Each field has instructions for how to fill it out—select the field to reveal the instructions.
+ **Request in Progress** – Some requests can't happen in parallel. You can only have one request to update specific information in progress for a product at a time. You can see all of your requests still under review on the **Requests** tab of the **Server products** page in AWS Marketplace Management Portal. If you have a pending request that you did not intend, you can cancel it and then submit a new request with the change that you want to make.
+ You can't update version information when an update (to add or restrict) a version is ongoing.
+ If there is a request pending from the AWS Marketplace Seller Operations team, you can't submit any new changes.
+ **Unexplained error** – If your submission fails with no explanation, try again. Occasionally, server load causes a submission to fail.
If you're still having problems with a change request, contact the [AWS Marketplace Seller Operations](https://aws.amazon.com/marketplace/management/contact-us/) team.