AWS Marketplace
User Guide for AWS Marketplace Providers

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Submitting Your Product for Publication

You use the product submission process to make your product(s) available on AWS Marketplace. Products can be quite simple, for example a single Amazon Machine Image (AMI) that has one price structure. Or, can be quite complicated, with multiple AMIs, AWS CloudFormation templates, and complex pricing options and payment schedules. You define your product offering and submit it through the AWS Marketplace Management Portal in one of two ways.

  • Using the Products tab – For products that are less complex, you use the Products tab to completely define and submit your request.

  • Using the Assets tab – For products that are more complex and require more definition, you download a product load form, add product details, and then upload the completed form using the File upload option.

We recommend that you start by using the Products tab to determine which approach to use. Existing or new product configurations might be added that might enable you to use the more automated, Products tab method. The following table lists some configuration and the approach you use to submit your request. The first column is the pricing model for your product, the other three columns are how the product is deployed to the customer.

Pricing Model Products Launched Using Single-Node AMI Products Launched with AWS CloudFormation Products Launched as Software as a Service (SaaS)
Bring Your Own License (BYOL) Products tab Assets tab  
Free Products tab Assets tab  
Hourly Products tab Assets tab  
Hourly with Annual Products tab Assets tab  
Monthly Assets tab Assets tab  
Hourly with Monthly Assets tab Assets tab  
Usage (MMS) Assets tab Assets tab  
SaaS Subscription     Products tab
SaaS Contract     Products tab
SaaS Legacy     Assets tab

You can submit products individually, or, if you use a product load form can submit multiple products or product updates at the same time. You cannot submit multiple products at the same time using the Products tab. If you are unclear on what products can be submitted in what manner, start by using the Products tab. If you have any problems making your submissions, contact the AWS Marketplace Managed Catalog Operations (MCO) team.

Using the Products Tab

To access the Products tab, log in to the AWS Marketplace Management Portal. From the Products tab, choose either Server, SaaS, or Machine learning, depending on the type of product you are managing. A dashboard for that product type appears that contains all of your current products. If you choose the Requests tab, the dashboard displays any outstanding requests you have, as well as view your completed request history. Once you start creating a new product request, you can save your work in progress, and if necessary, create your request in several different sessions.

When you are ready to submit your product request, the request is reviewed by the AWS Marketplace team. You can monitor the status of your request on the product page for they type of product you are requesting. For new products, once your request is approved for publication, you receive a limited listing URL that you use to preview and approve your submission. Your product offer is not published until you approve the submission. When you request an update to an existing product, the update is published without the need for you to review and approve the change. This includes adding/removing versions, and metadata changes.

You track the status of your requests under the Requests tab. The status will be one of the following:

  • Draft – you have started the request process but have not submitted your request.

  • Submitted – you have completed and submitted your request and it is under review.

  • Action Required – AWS Marketplace has reviewed your request and needs additional information.

  • Approval Required – AWS Marketplace has created the limited listing URL for your product and you must review and approve or reject the URL before AWS Marketplace will publish. If you approve, the status changes to Publishing Pending while the site gets published. If you reject, the status returns to Draft so you can modify the request.

  • Publishing Pending – You have approved the mock-up of your request and AWS Marketplace is publishing your product.

  • Expired – You started the request process, but did not complete within six months so the request expired.

If you have an entry with a status of Submitted, you can retract the submission. If you have an entry with a status of Draft, you can delete the request. This will allow you to start over. When you delete a Draft entry, the entry is moved to the Request History tab.

To add your product in the AWS GovCloud (U.S.) region, you must have an active AWS GovCloud (U.S.) account and comply with the AWS GovCloud (U.S.) requirements, including export control requirements.

Company and Product Logo Requirements

Your company logo and the logo for your products need to conform to our guidelines so that the user experience is uniform when browsing AWS Marketplace.

Product Logo Specifications – Your product logo image should have a transparent or white background and be 120 to 640 pixels in size, with a 1:1 or 2:1 (wide) ratio.

Company Logo Specifications – Your company logo image should have a transparent background and be 220 x 220 pixels in size, allowing for 10 pixels of padding on each side within.

AWS CloudFormation-Launched Product (Free or Paid) or Usage-Based Paid AMI Product

Products that AWS Marketplace customer launch by using AWS CloudFormation templates must be submitted using the Product Load Form available through the AMMP.

Submitting Your Product

  1. From the AMMP, download the Product Load Form for your product.

  2. Add your product definition, which includes product information (title, description, highlights), technical information (AMI_ID, regions, instance types, OS), and pricing details (pricing model, Free Trial).

  3. Submit your form following the instructions under the Instructions table of the spreadsheet.

AWS Marketplace reviews your product for policy and security compliance, software vulnerabilities, and product usability. If there are any questions or issues with a request, the AWS Marketplace team will contact you via email to discuss your request. Once approved, a mock-up of your product's page is created. After your review the page, you accept or reject the mock-up. Once approved, we add the page to the AWS Marketplace.

Updating Your Product

The Product Load Form is used to make one or more changes to the products you created using the Product Load Form. You can make changes to the original product load form you completed, or, if not available you can start with a new load form. Just like using the Products tab, you can add a new version, remove existing versions, and update pricing, instance types, region availability, and metadata. To make an update, you prepare any updated product the same way you do new products. Once the product is prepared:

  1. Use your existing product load form, or, from the AWS Marketplace Management Portal, under the Assets tab, choose File upload. Under Product load forms and seller guides, you can download the product load form for your product.

  2. Update your product submission in the product load form.

  3. From the AWS Marketplace Management Portal, under the Assets tab, choose File Upload.

  4. On the File Uploads page, upload your updated product load form, and any AWS CloudFormation templates. The file uploader provides a secure transfer mechanism and a history of submitted files. The uploader automatically notifies the AWS Marketplace team to begin processing your request. Include a description of the submission (adding new version, changing price, changing metadata, etc.).

Your product submission is reviewed for policy and security compliance, software vulnerabilities, and product usability. If there are any questions or issues with a request, the AWS Marketplace team will contact you via email. Updates to existing product pages are processed and released directly without additional reviews.

Product Changes and Updates

Sellers can submit changes to their product at any time, and they will be processed as described above. However, some changes can only be made every 90 or 120 days, or when pending changes are in place. Examples include price changes, and region/instance type changes. Common changes include:

  • New Version - New versions of the software, roll-outs of patches or updates. At your request, we can notify customers who have subscribed to Your Marketplace Content about the availability of new versions or send upgrade instructions on your behalf.

  • Metadata change - Changes to product information (Description, URLs, and Usage Instructions).

  • Pricing Change - A change to the pricing amount. A notification to current customers is sent once the request is complete.

  • Pricing Model Change - A change to the pricing model (i.e. Hourly, Free, Hourly_Annual). Not all pricing model changes are supported and all requests to change models must be reviewed and approved by AWS Marketplace. Note: Any change from a free to a paid model presents significant impact to existing customers. An alternative is to propose a new product with additional features and encourage current customers to migrate.

  • Region or Instance change - Adding or removing instances types or regions.

  • Product takedown - Remove a product page from AWS Marketplace to prevent new customers from subscribing. A notification to current customers is sent once the request is complete.

Timing and Expectations

While we strive to process requests as quickly as possible, requests can require multiple iterations and review by the seller and AWS Marketplace teams. Use the following as guidance for how long it will take to complete the process:

  • Total request time normally takes 2-4 weeks of calendar time; more complex requests or products can add additional time to allow for multiple iterations and adjustments to product metadata and software.

  • Review and processing of requests typically requires 3 business days. We will notify you if there are any issues that require additional action.

  • We require a completed product request and AMI at least 45 days in advance of any planned events or releases so we can prioritize the request accordingly.

If you have any questions about your request, contact the AWS Marketplace Seller Operations team.

Submitting AMIs to AWS Marketplace

ALL AMIs built and submitted to AWS Marketplace must adhere to all product policies. We suggest a few final checks of your AMI prior to submission:

  • Remove all user credentials from the system; all default passwords, authorization keys, key pairs, security keys or other credentials.

  • Ensure that root login is disabled / locked; only sudo access accounts are allowed.

  • If you are submitting an AMI to be deployed into the AWS GovCloud (US) region, you need to have an active AWS GovCloud account and agree to the AWS GovCloud Requirements, including applicable export control requirements.

AMI Self-Service Scanning

Self-service AMI scanning is available within the AWS Marketplace Management Portal. With this feature, you can initiate scans of your AMIs and receive scanning results quickly – typically in less than an hour – with clear feedback in a single location.

To begin sharing and scanning your AMI with this new service:

  1. Navigate to https://aws.amazon.com/marketplace/management/manage-products/.

  2. Select the AMI to share.

  3. View your scan results.

Once your AMI has successfully been scanned, you can follow the current process to submit the AMI for processing by the AWS Marketplace Seller and Catalog Operations team by uploading your product load form. For any problems, contact the AWS Marketplace Seller Operations team.

Note that in order for your AMI to be included in the self-service AMI scanning list, it must be in the us-east-1 (N. Virginia) region and owned by your AWS Marketplace seller account. If you need additional accounts whitelisted for the AWS Marketplace Management Portal, contact the AWS Marketplace Seller Operations team with the AWS Account ID that owns the AMI to be scanned.

AMI Cloning and Product Code Assignment

Once your AMI is submitted, AWS Marketplace will create cloned AMIs for each region that you have indicated that software should be available. During this cloning and publishing process, AWS Marketplace will attach a product code to the cloned AMIs. The product code is used to both control access and to meter usage. All submissions must go through this AMI cloning process.

Final Checklist

Use this checklist prior to submitting your product request to help avoid delays in publishing your product.

Product usage

  • Production-ready

  • Does not restrict product usage by time or other restrictions

  • Compatible with 1-click fulfillment experience

  • Everything required to utilize the product is contained within the software including client applications

  • Default user utilizes a randomized password and/or creation of initial user requires verification that the subscriber is authorized to use the instance using a value unique to the instance such as instance ID

For Free or Paid products:

  • No additional license is required to use the product

  • Subscriber does not have to provide personally identifiable information (e.g. email address) to use the product AMI preparation

  • Utilizes hardware virtual machine (HVM) virtualization and 64-bit architecture

  • Does not contain any known vulnerabilities, malware or viruses

  • Subscribers have OS-level administration access to the AMI

  • Run your AMI through AMI Self Service Scanning

For Windows AMIs:

  • Utilizes the most recent version of Ec2ConfigService

  • Ec2SetPassword, Ec2WindowsActiviate and Ec2HandleUserData are enabled

  • No Guest Accounts or Remote Desktop Users are present

For Linux AMIs:

  • Root login is locked/disabled

  • No authorized keys, default passwords or other credentials are included

  • All required fields are completed

  • All values are within specified character limits

  • All URLs load without error

  • Product image is at least 110px wide and between a 1:1 and 2:1 ratio

  • Pricing is specified for all enabled instance types (for hourly, hourly_monthly and hourly_annual pricing models)

  • Monthly pricing is specified (for hourly_monthly and monthly pricing models)

If you have any questions or comments about automated AMI building, contact the AWS Marketplace Seller Operations team.