# Preparing your product for AWS Marketplace
The following topics explain how to prepare your software products for sale through AWS Marketplace. Preparing your product involves configuring your package, setting a pricing scheme, determining the categories in which to list your product, and adding keywords so your product appears in relevant searches. If you are an independent software vendor (ISV), channel partner, managed services provider (MSP), or individual who has something to offer that works with AWS products and services, you can use this process to prepare to publish a product on AWS Marketplace.
**Topics**
+ [Product delivery for AWS Marketplace](#product-delivery)
+ [Designation for products running on AWS](#designation-delivery-methods)
+ [Product pricing for AWS Marketplace](pricing.md)
+ [Regions and countries for your AWS Marketplace product](regions-and-countries.md)
+ [Translation and languages](translation.md)
+ [Using standardized contracts in AWS Marketplace](standardized-license-terms.md)
+ [Providing metadata for AWS Marketplace products](categories-and-metadata.md)
+ [Creating AMI and container product usage instructions for AWS Marketplace](ami-container-product-usage-instructions.md)
+ [Optimizing your AWS Marketplace products for search](search-engine-optimization.md)
+ [Enhance your AWS Marketplace product with promotional media](promotional-media.md)
## Product delivery for AWS Marketplace
Each product delivery method has several options for packaging, pricing, and delivery. Some methods aren't available to you as a seller on AWS Marketplace until you register for the program supporting it.
You can create products with a standard list price and end user license agreement (EULA). You can also create private offers for individual customers with custom pricing and EULAs. If you need to make additional changes to the terms of the contract, you can work with the AWS Marketplace team to create a custom private offer. To simplify the procurement process, you can use [standardized license terms](standardized-license-terms.md) for both public product listings and private offers.
**Note**
AWS offers certain sellers the option to provide guided demonstrations on AWS Marketplace. If you're an AWS Partner Network (APN) partner who's eligible for [APN Customer Engagements (ACE)](https://aws.amazon.com/partners/programs/ace/) and you'd like to provide this option to buyers, see [Adding private offer and demo request buttons](creating-private-offer.md#private-offer-requests-demos) for more information.
The following table lists the methods that you can use to deliver software products, and the filters that AWS Marketplace buyers use to find each type of delivery method in the AWS Marketplace console.
| Product delivery method | Delivery Method filter on the console | Description |
| --- | --- | --- |
| Single AMI | Amazon Machine Image (AMI) | You deliver a single custom Amazon Machine Image (AMI) for your product. The AMI provides the information required to launch an Amazon Elastic Compute Cloud (Amazon EC2) instance. Buyers can use the single AMI to create Amazon EC2 instances with your product already installed and ready to use. For more information, see [AMI-based products in AWS Marketplace](ami-products.md). |
| AMIs delivered using AWS CloudFormation templates | CloudFormation Template | You can list AMI-based products that are delivered to AWS Marketplace buyers by using CloudFormation templates. For more information about delivering AMIs as a CloudFormation template, see [AMI-based delivery using AWS CloudFormation](https://docs.aws.amazon.com/marketplace/latest/userguide/cloudformation.html). For more information about CloudFormation templates, see [AWS CloudFormation concepts](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-whatis-concepts.html) in the *AWS CloudFormation User Guide*. |
| EC2 Image Builder component-based product | EC2 Image Builder component | You can list products delivered to AWS Marketplace buyers using EC2 Image Builder components. For more information about using EC2 Image Builder components, see [ Work with EC2 Image Builder component products](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-ec2-image-builder-products.html) in the *AWS Marketplace API Reference*. |
| Container-based product or application | Container | You deliver products packaged in container images. Container products consist of options, which are a set of container images and deployment templates that work together. For more information, see [Container-based products on AWS Marketplace](container-based-products.md). |
| Data products | AWS Data Exchange | You use AWS Data Exchange to create data products. For information about publishing and managing data products and offers through AWS Data Exchange, see [Providing data products on AWS Data Exchange](https://docs.aws.amazon.com/data-exchange/latest/userguide/providing-data-sets.html) in the *AWS Data Exchange User Guide*. |
| Machine learning algorithms and model packages | SageMaker Model | You use Amazon SageMaker AI to create the algorithm or model package, and then publish it on AWS Marketplace. For more information about delivering machine learning algorithms and model packages, see [Machine learning products in AWS Marketplace](machine-learning-products.md). For information about SageMaker AI, see [What is SageMaker AI?](https://docs.aws.amazon.com/sagemaker/latest/dg/whatis.html) in the *Amazon SageMaker AI Developer Guide*. |
| Software as a service (SaaS) | SaaS | You can offer SaaS products with subscription- based, contract-based, or contract with consumption pricing models. For more information, see [SaaS-based products in AWS Marketplace](saas-products.md). |
| Professional services | Professional services | You can offer professional services that support or work with other AWS Marketplace products. |
## Designation for products running on AWS
**Note**
The following designation goes into effect on May 1, 2025.
Products that are deployed on AWS receive a special designation in the AWS Marketplace search results and their product details pages. The following table lists the product delivery types that can receive the designation.
| **Product delivery method** | **Designated as deployed on AWS** |
| --- | --- |
| AMI-based | Yes |
| Container-based | Yes, except for products deployed on Amazon EKS Anywhere. For more information about container products that enable this functionality, see [Integrating an AWS Marketplace for Containers Anywhere with License Manager](container-anywhere-license-manager-integration.md) later in this guide. |
| SageMaker AI algorithm and model package-based | Yes |
| SaaS-based | Only for products that run entirely on AWS. For more information, refer to the [Architecture guidelines](saas-guidelines.md#saas-architecture) later in this guide. |
| Data-based | Yes |
| Professional services-based | No |
# Product pricing for AWS Marketplace
As an AWS Marketplace seller, you choose a pricing model for your products. For paid products, AWS Marketplace collects software charges from the customer. Public listings use US dollars (USD). Private offers support USD, EUR, GBP, AUD, JPY, and INR (for sellers in India only). There is no service fee for free or open-source software that is made available to customers without charge. This topic provides information about pricing models and pricing for software products in AWS Marketplace.
For information about refunds, see [Refunds and cancellations in AWS Marketplace](refunds.md).
**Topics**
+ [Pricing overview](pricing-overview.md)
+ [Pricing models](pricing-models.md)
+ [Multi-currency pricing for private offers](multi-currency-pricing.md)
+ [Changing pricing models](changing-pricing-models.md)
+ [Changing prices](#changing-prices)
+ [Private offers](private-offers.md)
+ [Refunds and cancellations in AWS Marketplace](refunds.md)
# Pricing overview
In AWS Marketplace, you can offer products for free, or you can charge for them. The charge becomes part of the buyer's AWS bill, and after the buyer pays, AWS pays the seller.
Products can take many forms, so the pricing models also take many forms. For example, you can offer a product as an Amazon Machine Image (AMI) that is instantiated using a buyer's AWS account. You can also configure products to use CloudFormation templates for delivery to the buyer. Products can also be SaaS offerings from an ISV, web access control lists (web ACL), sets of rules, or conditions for AWS WAF. Products can also be professional services from an ISV, channel partners, or managed services provider (MSP).
Flexible pricing options include free trial, hourly, monthly, annual, multi-year, and bring your own license (BYOL). AWS handles billing and payments, and charges appear on your customers’ AWS bills.
When you list a product or service, you must also include an end user license agreement and terms of service. That combination of product and license becomes an* offer*. You can use a standard EULA for public offers, isted price using an ISV’s standard end user license agreement (EULA). In addition, software products can be offered with custom pricing and EULA through private offers. Products can also be purchased under a contract with specifed time or usage boundaries.
# Pricing models
The following topics provide general information about the pricing models available in AWS Marketplace.
**Topics**
+ [Annual pricing](annual-pricing.md)
+ [Usage pricing](usage-pricing.md)
+ [Contract pricing](contract-pricing.md)
+ [Bring Your Own License pricing](BYOL-pricing.md)
For information about the pricing models for specific product delivery methods, see:
+ [AMI product pricing for AWS Marketplace](pricing-ami-products.md)
+ [Container products pricing for AWS Marketplace](pricing-container-products.md)
+ [Machine learning product pricing for AWS Marketplace](machine-learning-pricing.md)
+ [SaaS product pricing in AWS Marketplace](saas-pricing-models.md)
# Annual pricing
An annual pricing model enables you to offer products to customers who can purchase a 12-month subscription. As an example, the subscription pricing can provide up to 40 percent savings compared to running the same product hourly for extended periods. The customer is invoiced for the full amount of the contract at the time of subscription. For more information about how annual subscriptions are presented to customers, see [AMI subscriptions](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-ami-subscriptions.html) or [Pricing models for paid container products](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-what-is-aws-marketplace-for-containers.html#what-is-aws-marketplace-for-containers-pricing).
Considerations when working with an annual subscription include the following:
+ Annual pricing is defined per instance type. It can be the same for all Amazon Elastic Compute Cloud (Amazon EC2) instance types or different for each instance type.
+ All Annual instance types must also have an Hourly instance type defined. AWS Marketplace doesn't offer Annual-only pricing or Hourly without Annual on the same product. For any product offering Annual pricing, Hourly pricing also needs to be specified.
+ A \$10 Annual price is allowed on a specific instance type, if the Hourly price is also \$10 and there are other non-\$10 Annual instance types defined.
+ At the end of the annual subscription period, the customer will start being charged at the hourly price.
+ If a customer buys X Annual subscriptions but is running Y software on Y instances, then the customer is charged at Hourly software price for (Y-X) instances which are not covered by Annual subscriptions. As such, an Hourly rate must be included for all Annual pricing instance types.
+ Using seller private offers, you can offer a multi-year (up to 3 years) or custom duration AMI with upfront payment, or a flexible payment schedule. For more information about multi-year and custom duration contracts, see [Preparing a private offer for your AWS Marketplace product](private-offers-overview.md) and [Private offer installment plans](installment-plans.md).
If you offer an Annual product in AWS Marketplace, you agree to the specific refund policies for Annual products, located in the **File Uploader** documents section in the [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/tour).
# Price change
You can change annual prices (the \$1 value, for example \$11,000/year to \$11,200/year) every 90 days. However, you must give 90 days' notice to existing customers of annual pricing. The new price will apply to new subscriptions but will have no impact on existing subscriptions.
**Note**
During the 90 day notice period, you can't update the supported instance type.
Price changes will be effective for auto-renewals only if the price was changed at least 90 days before the auto-renewal date. The customer will receive an email message prior to auto-renewal that includes the new price.
# End user license agreement
An AWS customer’s usage of software for 12 months under an annual subscription is covered by the EULA that you provide on your product’s details page on AWS Marketplace.
# Usage pricing
A usage pricing model, also known as *pay as you go* pricing, enables you to offer products to customers who only pay for what they use.
Usage pricing private offers support multi-currency pricing in EUR, GBP, AUD, and JPY.
As a seller, you can choose one of the following usage categories:
+ **Users**
+ **Hosts**
+ **Bandwidth**
+ **Data**
+ **Tiers**
+ **Units** (for custom categories)
You can also define up to 200 dimensions for the product. Charges are measured and reported when the API is called by the software. We recommend that sellers configure the API to be called once per hour as a best practice, depending on their use case. All usage is calculated monthly and billed monthly using the same mechanism as existing AWS Marketplace software.
Using the AWS Marketplace Metering Service, you can handle several new pricing scenarios.
**Example Charge by Host**
If your software monitors hosts, you can charge for each host monitored and set different pricing based on the host size.
**Example Charge by User**
If your software allows multiple users across an organization, you can charge by user. Each hour, the customer is charged for the total number of provisioned users.
**Note**
In the Product Load Form (PLF), relevant columns are preceded with "FCP" (Flexible Consumption Pricing). For example: **FCP Category (Custom Pricing Category)**.
For AWS Marketplace Metering Service products, note the following:
+ If your software is already on AWS Marketplace, you will need to create a product to enable an alternate usage dimension. You can't convert a standard product to use the AWS Marketplace Metering Service. After the new product is published, you can remove the old product or keep both on the website.
+ The AWS Marketplace Metering Service requires that your software reports usage every hour, recording the customer usage for the hour. If there is a failure in the transmission or receipt of metering service records, AWS will be unable to bill for such usage. You are responsible for ensuring the successful receipt of metering records.
+ Products that use the AWS Marketplace Metering Service don't support 1-Click. Buyers are required to launch your software with an AWS Identity and Access Management (IAM) role with specific permissions and have an internet gateway.
+ Free Trial and Annual Pricing aren't compatible with the AWS Marketplace Metering Service.
+ Changing dimension (user, hosts, bandwidth, and data) or dimension name isn't supported. You will need to create a new product.
# Contract pricing
Using the contract pricing model, you can offer upfront pricing to customers that enables them to buy a license for 1 month, 12 months, 24 months, or 36 months.
Contract pricing is available for the following products:
+ Single AMI-based products and AMI with AWS CloudFormation template-based products. For more information, see [Contract pricing for AMI products on AWS Marketplace](ami-contracts.md)
+ Container-based products. For more information, see [Contract pricing for container products](container-license-manager-integration.md#container-contracts).
+ Software as a service (SaaS)-based products. For more information, see [Pricing for SaaS contracts](saas-contracts.md).
**Note**
Contract pricing for AMI and container-based products is only for new products.
If you have an existing AMI or container-based product and want to use contract pricing, create a new listing and then apply the contract pricing model by using the Product Load Form (PLF) to add different dimensions, integrate the AMI or container-based product with AWS License Manager, and then publish the AMI or container-based product.
When a customer purchases a product with contract pricing, a license is created by AWS Marketplace in the customer AWS account that your software can check using the License Manager API. Customers will need an IAM role to launch an instance of the AMI or container-based product.
# Bring Your Own License pricing
There is no service fee for Bring Your Own License (BYOL) products on AWS Marketplace.
To deliver on our customer promise of selection, we require that all BYOL products also have a paid option. This is so that customers who don’t have existing licenses have the option to purchase and use the products.
For BYOL products, we realize that the online purchase of software is a departure from how some companies do business. Therefore, for the first 90 days after launch, we will relax the requirement that this software is accompanied by a version available for purchase on AWS Marketplace. During this time, the AWS Marketplace account management teams will work with you to address challenges. The team can help you to determine if and how the software can be made available for purchase on AWS Marketplace.
# Multi-currency pricing for private offers
**Important**
You must configure disbursement preferences for each currency before creating offers in that currency.
Private offers can be created in buyer-preferred currencies: USD, EUR, GBP, AUD, JPY, and INR (India-based sellers only). This applies to:
+ Contract pricing
+ Contract with consumption pricing
+ Pay-as-you-go (PAYG) pricing
**Note**
Container product types private offers can be priced in non-USD currencies for contract only offers. For CCP and PAYG private offers, container pricing will remain in USD.
# Changing pricing models
Changes to pricing models must be reviewed and approved by AWS Marketplace to ensure a positive customer experience and reduced risk to all parties. Discuss the pricing model changes you want to make by contacting the [AWS Marketplace Seller Operations](https://aws.amazon.com/marketplace/management/contact-us/) team.
All requests for pricing model changes can take 30–90 days to process and review.
**Note**
Please note that pricing model change is not supported for SaaS products. For more information on SaaS product pricing, refer to [ SaaS product pricing in AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-pricing-models.html).
## Changing prices
You can update prices and metadata through the AWS Marketplace Management Portal.
**To change prices**
1. Sign in to the [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/).
1. In the **Products** tab, a list of current products that you created is available. Edit your product listing or request changes here.
**Note**
Price changes are automatically reflected on the product page in AWS Marketplace. New subscribers are subject to the price displayed on the product page. For existing subscribers of the public offer, price decreases take effect immediately. However, price increases become effective on the first day of the month following a 90-day notification period. For instance, if you send a price increase notification on March 16, the new price takes effect on July 1, the first day of the month after the 90-day period elapses.
# Private offers
In the AWS Marketplace Seller Private Offer program, AWS Marketplace sellers can negotiate custom pricing and EULAs with individual AWS Marketplace customers (buyers). For more information, see [Preparing a private offer for your AWS Marketplace product](private-offers-overview.md).
# Refunds and cancellations in AWS Marketplace
All paid products in AWS Marketplace must have a stated refund policy for software charges. The refund policy must include the terms of the refund and a method of contacting the seller to request a refund.
As a seller, you are responsible for defining the terms of your refund policy. However, we encourage you to offer buyers a refund option for usage of the product. You must comply with your posted refund policies.
AWS Marketplace provides self-service tools for sellers to initiate agreement cancellations and billing adjustments (refunds) directly from the **Agreements** page in AWS Partner Central (formerly AWS Marketplace Management Portal) or through the AWS Marketplace APIs, without requiring AWS Customer Service involvement. Billing adjustments are processed automatically after validation and do not require buyer approval. Cancellation requests are sent to buyers for approval with a 7-day response window.
**Note**
In AWS Partner Central, refunds are referred to as *billing adjustments*. Both terms refer to the same process of returning funds to a buyer or reducing the outstanding balance on an invoice.
**Topics**
+ [Refund request types for AWS Marketplace products](#refund-requests)
+ [AWS Marketplace product refund policy and approvals](#refund-approval)
+ [Requesting an agreement cancellation](#requesting-cancellation)
+ [Requesting a billing adjustment (refund)](#refund-process)
+ [Tracking cancellation requests](#tracking-cancellations)
+ [Tracking billing adjustments](#tracking-billing-adjustments)
+ [Notifications](#scaba-notifications)
+ [Using the AWS Marketplace APIs](#scaba-apis)
+ [Channel Partner Private Offers (CPPO)](#cppo-cancellations-adjustments)
+ [Requesting a bulk refund](#bulk-refund-process)
+ [Legacy refund request process](#legacy-refund-process)
## Refund request types for AWS Marketplace products
Buyers can request different types of refunds for AWS Marketplace products. For AWS Marketplace products sold by AWS, refer to the refund policy page and then submit a support case using the [Support Center Console](https://console.aws.amazon.com/support/home?). If a buyer requests a software refund directly from AWS, we instruct them to contact the seller using the support contact information you provided for the product in question. Refunds of any AWS infrastructure charges are at the discretion of AWS and are handled separately from software refunds.
For products sold by a third-party seller, buyers must refer to the product detail page to view the refund policy. Software charges for AWS Marketplace subscriptions are paid to the seller of record, and refunds must be requested from the seller directly.
## AWS Marketplace product refund policy and approvals
The following list describes the AWS Marketplace refund policy and whether your approval is needed:
+ **Free trials** — If you list your software as a free trial product, AWS can issue refunds on your behalf for software charges that accrue within seven days of converting to a paid subscription. Refunds issued in connection with free trial conversions require no action on your part. By enabling a free trial on a product, you agree to this policy.
+ **Private offers** — All refunds for private offers must be authorized by you before AWS can process them.
+ **Software metering refunds** — If you use the AWS Marketplace Metering Service to meter the usage of your software, AWS can issue refunds on your behalf for software charges resulting from software metering errors. If these errors are common across multiple buyers, AWS reserves the right to determine an appropriate refund for each buyer and apply it directly to each buyer. By using the AWS Marketplace Metering Service with a product, you are agreeing to this policy.
+ **Subscription cancellation within 48 hours of purchase** — If a buyer cancels their subscription within 48 hours of a non-private offer purchase, AWS issues a full refund (cancel with 100 percent refund). Refunds issued in connection with cancellation within 48 hours of purchase require no action on your part. After 48 hours, such buyer request is at your discretion. By listing your product on AWS Marketplace, you agree to this policy.
+ **Subscription upgrade** — If a buyer replaces an existing non-private offer subscription with a more expensive subscription or a subscription of equal value, AWS can issue refunds on your behalf for the lower-tier subscription.
+ **Subscription downgrade** — All downgrade subscription refund requests must be authorized by you before AWS can process them.
+ **Seller-initiated billing adjustments** — As the seller of record, you can initiate billing adjustments (refunds) for any agreement through the **Agreements** page in AWS Partner Central or through the Billing Adjustments API. Billing adjustments don't require buyer approval and are processed automatically after validation. Refunds are irreversible after they've been processed.
+ **Seller-initiated cancellations** — As the seller of record, you can initiate agreement cancellation requests through the **Agreements** page in AWS Partner Central or through the Cancellation API. Cancellation requests are sent to the buyer for approval. If the buyer doesn't respond within 7 days, the cancellation is automatically approved and the agreement is canceled.
All AWS-authorized refunds are processed automatically and require no action on your part.
## Requesting an agreement cancellation
You can initiate an agreement cancellation request from the **Agreements** page in AWS Partner Central. Cancellation requests are sent to the buyer for approval. The buyer has 7 days to approve or deny the request. If the buyer doesn't respond within 7 days, the cancellation is automatically approved and the agreement is canceled.
**Important**
Cancellation only cancels future invoices that have not been issued. It doesn't automatically refund existing open invoices. If you also need to refund past charges, you must submit a separate billing adjustment request. See [Requesting a billing adjustment (refund)](#refund-process).
### Prerequisites
+ You must be the seller of record for the agreement. For Marketplace Private Offers (MPPO), this is the ISV. For Channel Partner Private Offers (CPPO), this is the channel partner (CP).
+ The agreement must be active.
+ There must not be an existing active cancellation request for the same agreement.
+ No related agreement should exist for the agreement being canceled. For instance, a usage agreement can't be canceled if it has an associated annual discount agreement.
### To request an agreement cancellation
1. Sign in to [AWS Partner Central](https://aws.amazon.com/marketplace/management) and navigate to the **Agreements** page.
1. Select the agreement you want to cancel and choose **Request cancellation**.
1. Review the agreement information (Buyer account ID, Agreement ID, Offer ID). Choose a cancellation reason from the dropdown. In the **Additional details** field, you can optionally include a message to the buyer.
1. Choose **Submit request**.
1. Upon successful submission, you'll receive a link to the buyer response form. You can optionally expedite the process by sharing the response form link with the buyer directly. You can also copy the link later from the **Cancellation requests** tracking table.
### Withdrawing a cancellation request
You can withdraw a pending cancellation request from either the **Cancellation requests** tab or the request details page. To withdraw a pending request from the **Cancellation requests** tab, select the request you want to withdraw and choose **Withdraw request**. In the dialog box, provide a withdrawal reason.
## Requesting a billing adjustment (refund)
You can initiate billing adjustments (refunds) from the **Agreements** page in AWS Partner Central. Billing adjustments allow you to either refund buyers for charges on existing invoices, or reduce the outstanding balance on invoices that have not yet been paid. Billing adjustments don't require buyer approval and are processed immediately upon successful validation.
**Important**
If the billing adjustment you want to apply is dependent on cancellation of the agreement, submit the cancellation request first and wait for approval before submitting the billing adjustment.
### Prerequisites
+ You must be the seller of record for the agreement. For Marketplace Private Offers (MPPO), this is the ISV. For Channel Partner Private Offers (CPPO), this is the channel partner (CP).
+ To adjust invoices issued in countries with Know Your Customer (KYC) compliance requirements, you must first complete secondary user verification and enable multi-factor authentication (MFA). To become KYC-verified, see [Complete the Know Your Customer process](https://docs.aws.amazon.com/marketplace/latest/userguide/complete-kyc-process.html) and [Managing your secondary user for KYC](https://docs.aws.amazon.com/marketplace/latest/userguide/managing-secondary-users.html) for more information.
### To apply a billing adjustment
1. Sign in to [AWS Partner Central](https://aws.amazon.com/marketplace/management) and navigate to the **Agreements** page.
1. Select the agreement you want to adjust and choose **Apply billing adjustment**.
The billing adjustment wizard guides you through four steps:
**Step 1: Provide details**
Review the agreement information (Buyer account ID, Agreement ID, Offer ID). Choose a billing adjustment reason from the dropdown. In the **Additional details** field, you can optionally include a message to the buyer. Choose **Next**.
**Step 2: Select invoices**
In the **Available invoices** table, select the invoices you want to adjust. You can filter invoices by either invoice date or billing period. Choose **Next**.
**Step 3: Adjust billing amounts**
You can either start from zero and manually enter custom adjustment amounts for each selected invoice, or you can start from the maximum adjustment amount per invoice and optionally modify individual amounts as needed. The value you enter must be a positive number and can't exceed the maximum adjustment amount for that invoice, and is exclusive of taxes. If the maximum adjustment amount is less than the original charge amount, this indicates that a partial adjustment was previously applied. In this case, the maximum adjustment amount represents the remaining balance. After you've made your adjustments, choose **Next**.
**Step 4: Review and apply**
Review the details of your billing adjustment to ensure that all the information is correct. Next, choose **Apply billing adjustment**. In the confirmation window, provide written confirmation by typing the total adjustment amount.
**Important**
Billing adjustments are irreversible after they have been processed. For unpaid invoices, adjustments are deducted from the total amount due. For paid invoices, adjustments are applied as either credit memos or cash refunds.
The buyer is notified by email and Amazon EventBridge event when the billing adjustment is processed.
## Tracking cancellation requests
You can track all cancellation requests from the **Cancellation requests** tab on the **Agreements** page.
1. Sign in to [AWS Partner Central](https://aws.amazon.com/marketplace/management).
1. Navigate to the **Agreements** page.
1. Choose the **Cancellation requests** tab.
The cancellation requests table displays the following columns: Request ID, Request status, Agreement ID, Buyer ID, Request date, and Response date.
You can filter by **status** or **agreement ID**.
To view details of a specific request, select the request and choose **View details**. You can also choose **Withdraw request** to withdraw a pending request, or **Copy link** to copy the buyer approval link.
### Cancellation request statuses
| API status | UI label | Description |
| --- | --- | --- |
| Pending approval | Pending approval | The request has been submitted and is waiting for the buyer to approve or deny. The buyer has 7 days to respond. If no response is received, the request is automatically approved. |
| Approved | Approved | The buyer approved the cancellation, or the request was automatically approved after 7 days. The agreement is canceled. |
| Rejected | Denied | The buyer denied the cancellation request. You can submit a new request if needed. |
| Canceled | Withdrawn | You withdrew the cancellation request before the buyer took action. |
| Validation failed | Validation failed | The request did not pass automated validation. |
## Tracking billing adjustments
You can track all billing adjustment requests from the **Billing adjustments** tab on the **Agreements** page.
1. Sign in to [AWS Partner Central](https://aws.amazon.com/marketplace/management).
1. Navigate to the **Agreements** page.
1. Choose the **Billing adjustments** tab.
The billing adjustments table displays the following columns: Adjustment ID, Invoice ID, Status, Agreement ID, Buyer ID, Submitted, Processed, and Creation date.
You can filter by **agreement ID**, **creation date**, or **status**.
**Note**
If you submitted billing adjustments for multiple invoices in a single request, each invoice appears as a separate row in the table. All rows from the same submission will have different billing adjustment request IDs.
### Billing adjustment statuses
| API status | UI label | Description |
| --- | --- | --- |
| Pending | In progress | The adjustment has been submitted and is being processed. |
| Completed | Adjusted | The adjustment was processed successfully. The buyer receives a credit memo or cash refund. |
| Validation failed | Failed | Your billing adjustment request failed automated checks. You may need to submit a new request with corrected information. |
## Notifications
You receive automated notifications for cancellation and billing adjustment status updates through two channels:
+ **Email notifications** — Sent to the root email associated with your AWS account. You can also [add custom email aliases](https://docs.aws.amazon.com/marketplace/latest/userguide/email-notifications.html#adding-updating-email-addresses) for notifications and [unsubscribe recipients](https://docs.aws.amazon.com/marketplace/latest/userguide/email-notifications.html#unsubscribe-notifications) from email notifications.
+ **[Amazon EventBridge](https://docs.aws.amazon.com/marketplace/latest/userguide/notifications-eventbridge.html) events** — Sent to your account's default event bus, which you can use to trigger automated workflows.
### Cancellation notifications
| Event | Recipients | Email subject (seller) |
| --- | --- | --- |
| Cancellation request submitted | Seller, Buyer, Manufacturer (CPPO) | "You submitted an agreement cancellation request" |
| Cancellation request approved (by buyer or auto-approved) | Seller, Buyer, Manufacturer (CPPO) | "Agreement cancellation request approved" |
| Cancellation request denied by buyer | Seller, Buyer, Manufacturer (CPPO) | "Agreement cancellation request denied" |
| Cancellation request withdrawn by seller | Seller, Buyer, Manufacturer (CPPO) | "Agreement cancellation request withdrawn" |
| Cancellation request failed validation | Submitter only | "Agreement cancellation request failed" |
When a cancellation request is submitted, the seller's email also includes a **response form URL** that can be shared directly with the buyer to expedite approval.
### Billing adjustment notifications
| Event | Recipients | Email subject (seller) |
| --- | --- | --- |
| Billing adjustment processed | Seller, Buyer, Manufacturer (CPPO) | "Billing adjustment processed" |
| Billing adjustment failed validation | Submitter only | "Billing adjustment request failed" |
**Note**
Billing adjustments don't generate a "submitted" notification. You receive a single notification when the adjustment is completed or if it fails.
**Note**
If a billing adjustment fails instantly (for example, the refund amount exceeds the maximum refundable amount), the request is not created and no notification is sent. You see the error directly in the console or receive an error code through the API.
**Important**
For CPPO agreements, the ISV (manufacturer) receives notifications when the channel partner submits or completes cancellation and billing adjustment requests. However, the refund amount and message to buyer are **not** included in ISV notifications to protect channel partner margin information.
## Using the AWS Marketplace APIs
In addition to the console experience, you can manage cancellations and billing adjustments programmatically using the AWS Marketplace APIs.
### Cancellation API
The AWS Marketplace Self-Service Cancellation API enables you to manage agreement cancellation requests programmatically.
**Endpoint:** `https://agreement-marketplace.us-east-1.amazonaws.com`
| Operation | Description |
| --- | --- |
| SendAgreementCancellationRequest | Initiate a new cancellation request for an agreement |
| AcceptAgreementCancellationRequest | Accept a pending cancellation request (buyer action) |
| RejectAgreementCancellationRequest | Reject a pending cancellation request with a reason (buyer action) |
| CancelAgreementCancellationRequest | Withdraw a pending cancellation request (seller action) |
| GetAgreementCancellationRequest | Retrieve details of a specific cancellation request |
| ListAgreementCancellationRequests | List cancellation requests with optional filters. Supports pagination. |
### Billing Adjustments API
The AWS Marketplace Billing Adjustments API enables you to manage billing adjustments (refunds) programmatically.
**Endpoint:** `https://agreement-marketplace.us-east-1.amazonaws.com`
| Operation | Description |
| --- | --- |
| ListAgreementInvoiceLineItems | Retrieve invoice line items for an agreement to identify invoices eligible for adjustment |
| BatchCreateBillingAdjustmentRequest | Create billing adjustment requests for one or more invoices (up to 5 per request) |
| GetBillingAdjustmentRequest | Retrieve details of a specific billing adjustment request |
| ListBillingAdjustmentRequests | List billing adjustment requests with optional filters. Supports pagination. |
## Channel Partner Private Offers (CPPO)
For Channel Partner Private Offers (CPPO), the following rules apply:
+ Only the channel partner (CP), as the seller of record, can initiate cancellation and billing adjustment requests for CPPO agreements. The ISV can't initiate these requests.
+ The ISV (manufacturer) receives email and Amazon EventBridge notifications when the CP submits a cancellation or billing adjustment request.
+ ISV notifications include the selling authorization ID, Product ID, and Buyer AWS account ID, but don't include the refund amount or message to buyer to protect CP margin information.
+ The CP can view and track all active and historical cancellation and billing adjustment requests for CPPO agreements on the **Agreements** page and through the APIs.
## Requesting a bulk refund
You can also process billing adjustments programmatically using the Billing Adjustments API (`BatchCreateBillingAdjustmentRequest`), regardless of the number of invoices. See [Using the AWS Marketplace APIs](#scaba-apis).
The following steps explain how to create refund requests involving 20\$1 invoices or 20\$1 accounts using a support case. This process streamlines large-scale refund requests and ensures that you provide the necessary information.
**To request a bulk refund**
1. Gather the following required information:
+ The seller's AWS account ID (12 digits)
+ A list of all buyer AWS account IDs (12 digits each). You can enter multiple buyers, or single buyers for multiple billing periods.
+ All product IDs
+ Offer IDs where applicable
+ All invoice IDs
+ The billing periods for each invoice
+ The AWS Marketplace Refund Ticket Reference ID
1. Compile the required information into a CSV spreadsheet with the following columns:
+ **Seller Account ID**
+ **Subscriber Account ID**
+ **Payer Account ID**
+ **Billing Period**
+ **Invoice ID**
+ **Targeted Amount**
+ **Product ID**
1. Sign in to the [Support Center Console](https://console.aws.amazon.com/support/home?) as the root user.
**Note**
You can't complete these steps unless you sign in as the root user.
1. Create a support case to **Account and billing** and select **AWS Marketplace**.
1. In the subject line, enter **Request Bulk Refund**.
1. Under **Additional Comments**, enter the following:
+ Total number of accounts affected
+ Total number of invoices
+ Total refund amount
+ Business justification for the refund
+ AWS Marketplace Refund Ticket Reference ID
1. Attach the CSV file and create the support case.
1. The support case is routed to the next available agent for assistance.
## Legacy refund request process
**Important**
The following legacy refund request process is being replaced by the new self-service workflows through the **Agreements** page. For cases not currently supported by the new experience, you can continue to use this process. This process will be deprecated in the future as support for additional cases is added to the self-service workflow. We recommend using the **Agreements** page or the AWS Marketplace APIs for all supported requests.
The legacy process for requesting refunds:
**Step 1: Submit a refund and/or cancellation request**
1. Sign in to [AWS Partner Central](https://aws.amazon.com/marketplace/management).
1. Choose **Marketplace refund support** (or **Support** in the former AWS Marketplace Management Portal).
1. Choose **Request Refund**.
1. Enter the following details:
+ **Subscriber's AWS account ID** — The buyer's account ID used to subscribe. You can find this in the offer detail or on the Billed Revenue Dashboard. This must be the subscriber account ID.
+ **Seller's AWS account ID** — Your AWS account ID used to create the offer.
+ **Product ID** — You can find this in the offer detail or on the Billed Revenue Dashboard.
+ **Billing period** — You can find this on the Billed Revenue Dashboard. For monthly usage invoices, this is the calendar month previous to the invoice date.
+ **Refund amount** — Indicate full or partial refund.
1. In the **Additional comments (optional)** field:
+ For contract cancellation, include: "Please cancel agreement *agreement-id*".
+ For refunds (whether the invoice has been paid or not), include: "This refund targets invoice ID *invoice-id* dated *invoice-date*".
+ If you need both cancellation and refund, include both statements. Cancellation of a contract does not automatically cancel any issued invoices — you must explicitly request refund of each invoice that needs to be adjusted.
1. Submit the form and save the reference ID generated on submission for further communication with AWS.
**Step 2: (Optional) Create a support ticket to expedite the request**
If a refund and/or cancellation needs to be expedited, you can create a support case directly with the AWS Customer Service team:
1. Sign in to the [Support Center Console](https://console.aws.amazon.com/support/home?).
1. Create a new case with the following details:
+ **Type:** Account and Billing
+ **Service:** Marketplace
+ **Category:** Marketplace Seller Request
+ **Severity:** General question
+ **Subject:** "Please expedite refund and/or cancellation request"
+ **Description:** "Please expedite the refund and/or cancellation request related to reference ID: *reference-id*" (the reference ID from Step 1)
For information about the new self-service process, see [Requesting an agreement cancellation](#requesting-cancellation) and [Requesting a billing adjustment (refund)](#refund-process).
# Regions and countries for your AWS Marketplace product
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 this topic to learn more about Regions and countries for your AWS Marketplace product.
**Sellers in India**
Sellers in India have geographic restrictions and can only sell to buyers in India. For detailed information, see [Getting started as a seller in India](getting-started-seller-india.md).
## AWS Regions
When creating or editing server or machine learning product information, you can limit your product to specific AWS Regions where your users can install and use the product.
For server products, including Amazon Machine Image (AMI)-, container-, and CloudFormation-based products, you can select specific Regions where the product is available. You can also choose to automatically make your product available in new US Regions, non-US Regions, or all Regions as they become available.
For machine learning products, you can either select specific Regions, or all Regions including future Regions as they become available.
For more information about AWS Regions, see [AWS service endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html) in the AWS General Reference.
## Countries
By default, your product is available to buyers in all countries where AWS Marketplace is available. For new and existing server and software as a service (SaaS) products, you can control product availability in specific countries for tax, compliance, support, or marketing purposes.
There are exceptions to this functionality:
+ **Previous purchases** – After updating your product with a new list of countries, buyers that have already subscribed to your product will still have access while their subscription is active.
+ **Private offers** – When you limit your product to buyers in specific countries, it does not limit private offers. When you create a private offer to a specific buyer, it is available to that buyer, even if they are in a country that you did not include in your specified countries.
**Note**
Customer eligibility is determined at an AWS linked account level. For more information, see [How does AWS determine the Location of your account?](https://aws.amazon.com/tax-help/location/)
Customers that share their entitlement can only activate the entitlement in a region you have allowed. For more information about managing entitlements, see [Sharing subscriptions in an organization](https://docs.aws.amazon.com/marketplace/latest/buyerguide/organizations-sharing.html) in the *AWS Marketplace Buyer Guide*.
# Translation and languages
By default, AWS Marketplace translates your product listings and offers into the following languages:
+ French (fr-FR)
+ Japanese (ja-JP)
+ Korean (ko-KR)
+ Spanish (es-ES)
AWS Marketplace also provides a set of example standard contracts, for reference only, in those languages. The contracts are not legally binding. For more information about the contracts, see [Supported languages](https://docs.aws.amazon.com/marketplace/latest/buyerguide/supported-display-languages.html) in the *AWS Marketplace Buyer Guide*.
The following topics explain how translation works, how to download the translated standard contracts, and how to opt out of translation.
**Topics**
+ [Getting started](#translation-get-started)
+ [Opting out of translation](#translation-opt-out)
## Getting started
Remember the following about AWS Marketplace translations:
+ To help expand your reach to global markets, AWS Marketplace translates the English content you provide with no additional effort from you. If you have issues with a translation, use the [Contact Us](https://aws.amazon.com/marketplace/management/contact-us) page in the AWS Marketplace Management Portal. Choose the **Product Listing** and **Local Languages Opt-out** categories, and provide feedback about the issue.
AWS Marketplace can make limited changes, such as not translating technical terms or product names.
+ You can opt out of having your listings translated. If you do, buyers see your content in English and any related AWS Marketplace content in their preferred language. For more information about opting out, see [Opting out of translation](#translation-opt-out) below.
+ You must submit your seller registration and product listing information in English.
+ You can submit EULAs in the supported languages. The related product listings must be geo-targeted, and the language must be the country's primary language.
AWS Marketplace provides a set of standard example contracts, for reference only, translated into the languages listed above. You can download the contracts from [Supported languages](https://docs.aws.amazon.com/marketplace/latest/buyerguide/supported-display-languages.html) in the *AWS Marketplace Buyer Guide*.
+ As a best practice, when you publish a new product, review the translation with the product in the limited state. [Contact Us](https://aws.amazon.com/marketplace/management/contact-us) with any issues before you make the product public.
+ The translation process begins after you move a product to a limited state. Buyers see English text until the translations become available.
## Opting out of translation
The following steps explain how to opt out of having your product listings translated. You can opt out of some or all languages. For example, you can have a listing translated only into French and Japanese.
Allow 3 – 5 days for the opt-out to take effect.
**To opt out**
1. Go to the [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/tour/) and choose **Contact Us**.
1. Select the following categories in the order listed:
+ **Commercial Marketplace**
+ **Product Listing**
+ **Local Languages Opt-out**
1. Include the listing ID and the languages that you want to opt out of.
1. As a best practice, help your buyers understand why they see English text. For example:
1. When opting out of all translations, add **English** to the end of your product name.
1. When opting out of one or more translations, add some explanatory text to the end of your product description. For example: **We have declined automatic translation services for this product**.
1. Submit your request.
# Using standardized contracts in AWS Marketplace
When you [prepare your product](product-preparation.md) as an AWS Marketplace seller, you need to determine which end user license agreement (EULA) will govern the use of your product. You can use the following:
+ Your own EULA.
+ The Standard Contract for AWS Marketplace (SCMP), a contract template that can help streamline procurement workflows and speed transactions. You can also use the Federal Addendum to the SCMP to help speed U.S. Government procurement.
+ The Reseller Contract for AWS Marketplace (RCMP), a standardized reseller contract template that ISVs can use.
The following topics explain how to use the standardized AWS Marketplace contracts templates.
**Topics**
+ [Standard Contract for AWS Marketplace](#standard-contracts)
+ [Reseller Contract for AWS Marketplace](#reseller-contract-for-aws-marketplace)
## Standard Contract for AWS Marketplace
AWS Marketplace developed the [Standard Contract for AWS Marketplace (SCMP)](https://s3.amazonaws.com/aws-mp-standard-contracts/Standard-Contact-for-AWS-Marketplace-2022-07-14.pdf) in collaboration with the buyer and seller communities. The SCMP governs usage and defines the obligations of buyers and sellers for digital solutions. Examples of digital solutions include server software, software as a service (SaaS), and artificial intelligence and machine learning (AI/ML) algorithms).
The SCMP proactively defines common ground across key contractual clauses like use, warranty, indemnification, and governing law. Sellers can offer SCMP terms as the EULA for self-service transactions, where buyers can search for, buy, and quickly deploy solutions. For [private offers](private-offers-overview.md), buyers can request the SCMP template from the seller, and the terms can be amended to address custom transaction requirements as agreed upon by the parties.
You can also use the following optional addendums with the SCMP for self-service or private offers:
+ [Enhanced Security Addendum ](https://s3.amazonaws.com/aws-mp-standard-contracts/Enhanced-Security-Addendum-for-Standard-Contract-for-AWS-Marketplace-SCMP-2022-06-17.pdf) – Supports transactions with elevated data security requirements.
+ [HIPAA Business Associate Addendum ](https://s3.amazonaws.com/aws-mp-standard-contracts/Business-Associate-Addendum-for-Standardized-Contracts-for-AWS-Marketplace-2022-06-17.pdf) – Supports transactions with Health Insurance Portability and Accountability Act of 1996 (HIPAA) compliance requirements.
+ [ Federal Addendum](https://d1.awsstatic.com/awsmp/solutions/mk-sol-files/standardized-contracts/Federal-Addendum-for-Standard-Contract-for-AWS-Marketplace.pdf) – Supports software purchases involving the U.S. Government.
**Disclaimer**
The EULA is between you and the buyer. Using the SCMP as your EULA is at your discretion. By applying the SCMP to your product listing, you are opting in to the SCMP program. Under this program, AWS may update the SCMP template periodically and may update product listings carrying the terms with the current version. You may withdraw from the SCMP program at any time by replacing the SCMP template with your own EULA.
### Getting started with the SCMP
You can update a EULA to the SCMP and offer it to buyers of new and existing single Amazon Machine Instance (AMI) and software as a service (SaaS) products. The procedure that you use to request the update depends on whether a product is or is not listed through a self-service listing (SSL).
If you have questions, send an email message to the AWS Marketplace Standard Contracts team at aws-mp-standardcontract@amazon.com.
**To update a EULA to the SCMP for AMI and SaaS products listed through SSL**
1. Review the terms of the [Standard Contract for AWS Marketplace](https://s3.amazonaws.com/aws-mp-standard-contracts/Standard-Contact-for-AWS-Marketplace-2022-07-14.pdf).
1. Sign in to the [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/).
1. For products, choose the **product type** and select the **product listing** for which you want to update the contract.
1. Choose **Request Change** and then choose **Update regions and pricing**.
1. Choose **Standard Contract for AWS Marketplace** for the EULA if it's not already selected.
1. In **Notes & Notifications**, type **Please update this product to SCMP V2**.
1. Review the changes, and choose **Submit for review**.
**To update a EULA to the SCMP for AMI and SaaS products not listed through SSL**
1. Open the [Contact us](https://aws.amazon.com/marketplace/management/contact-us/) page on the AWS Marketplace Management Portal.
1. Sign in to your AWS Marketplace seller account.
1. Complete the form as follows:
+ For the subject of your question, choose **Commercial Marketplace**.
+ For the category, choose **Product Listing**.
+ For the subcategory, choose **Standard Contract Request**.
+ In the description, type **Please update these products to SCMP V2** and provide the product titles and IDs that you want to update with the SCMP.
## Reseller Contract for AWS Marketplace
The Reseller Contract for AWS Marketplace (RCMP) is a standardized reseller contract template that ISVs can use when authorizing channel partners to resell ISV products to AWS Marketplace buyers. The contract helps reduce redundancy in legal contract reviews and accelerates time to market when ISVs and channel partners enter into a reseller relationship and/or use the reseller terms for their [channel partner private offer (CPPO)](https://aws.amazon.com/marketplace/features/cpprivateoffers). When creating a CPPO, ISVs can upload the contract to the opportunity (Resale Authorization), and then channel partners can view and accept the contract. AWS Marketplace buyers can't view the RCMP.
**Disclaimer**
The RCMP is an optional contract for ISVs. If ISVs decide to resell their product through a channel partner, they can either attach the RCMP or their own customized contract terms—existing or pre-negotiated—when creating an opportunity.
### Getting started with the RCMP
This section describes how to review terms and use the RCMP.
**To use the RCMP while creating an AWS Marketplace opportunity**
1. Review the terms of the [Reseller Contract for AWS Marketplace](https://s3.amazonaws.com/aws-mp-rcmp/Reseller-Contract-for-AWS-Marketplace-2021-12-01.pdf).
1. Follow the steps in [Create a resell opportunity for a channel partner](https://docs.aws.amazon.com/marketplace/latest/userguide/channel-partner-isv-info.html) while referring to the [RCMP guide](https://s3.us-west-2.amazonaws.com/external-mp-channel-partners/Reseller+Contract+for+AWS+Marketplace.pdf).
# Providing metadata for AWS Marketplace products
As a seller, when you add a product to AWS Marketplace, you specify product metadata. Product metadata includes the name, description, categories, and keywords that you use to describe your product for customers. AWS Marketplace revises product metadata solely for quality assurance and error correction. This topic provides information and best practices that you, as an AWS Marketplace seller, can use to effectively name, describe, and categorize your products.
**Note**
All product detail page tabs and sections, such as **Pricing**, **Usage**, **Similar products**, or **Product comparison**, are dynamic and managed by AWS Marketplace. Sellers cannot customize product detail pages to add or remove a section.
## Naming and describing your product
The information that you provide about your product is visible to buyers. Ensure that potential buyers have enough information to make informed decisions about buying your product.
### Creating the product name
Keep the following guidelines in mind as you create the product name:
+ Use title case (capitalize the first letter of each important word)
+ Ensure that a buyer can identify the product by the name alone
+ Use the name of the brand or manufacturer
+ Avoid descriptive data or hyperbole
Example product name: Smart Solution Load Balancer - Premium Edition.
**Supported characters**
Supported characters for metadata fields are:
+ ASCII character codes 0 to 126
+ For more information see [Standard ASCII Table](https://www.ascii-code.com/ASCII).
+ Copyright ©
+ Registered ®
+ Trademark ™
+ Currency symbols ¢ £ ¤ ¥
### Writing the product description
The product description lists the product's features, benefits, and usage. It can also provide other relevant, specific product information. The description can be up to 350 characters long.
Keep the following guidelines in mind as you write the product description:
+ Avoid unnecessary capitalization
+ Avoid unnecessary punctuation marks
+ Don't include redirect information
+ Check spelling and grammar
+ Include only critical, useful information
+ Avoid descriptive data and hyperbole
Example product solution: Smart Solution automatically distributes incoming application traffic across multiple Amazon EC2 instances. It enables you to achieve even greater fault tolerance in your applications, providing the amount of load-balancing capacity you need to respond to incoming application traffic. Smart Solution detects unhealthy instances in a pool and automatically reroutes traffic to healthy instances until the unhealthy instances are restored. You can enable Smart Solution in a single AWS Availability Zone or across multiple Availability Zones to ensure more consistent application performance.
### Writing the product highlights
The product information page displays up to three product highlight bullet points. Use these bullet points to briefly describe the product's primary selling points.
Example product highlight: Projecting costs: With Smart Solution, you pay only for what you use. You're charged for each hour or partial hour that Smart Solution is running.
### Writing the support information
Customers must be able to easily get help with issues, such as using the services, troubleshooting, and requesting refunds (if applicable). You must specify support contact options such as email, a phone number or a support web form link on the fulfillment landing page.
## Choosing categories and keywords
When you list your product, you can choose up to three software categories and corresponding subcategories for your product. This helps buyers discover your product as they browse or search for products on AWS Marketplace. Choose only categories that are relevant to your product; in most cases, only one category applies. The product load form and the **Products** tab both contain a complete list of categories.
Categories aren't the same as keywords. The categories and subcategories available are predefined for AWS Marketplace, and you decide which ones apply to your product by selecting them from a list during the product request process. Keywords aren't predefined, but are created during the process. You don't need to add the category as a keyword.
### Creating search keywords
During the product request process, you can enter up to three keywords (single words or phrases) to help buyers discover your product through site searches. The keywords field can contain a maximum of 250 characters.
The following tips can help you to create a relevant set of search keywords:
+ Use relevant terms.
+ Don't use the names of products published by other sellers or use other sellers' names.
+ Choose keywords from your buyer's vocabulary—that is, words and phrases that buyers are likely to use when thinking about your type of product.
+ Create keywords based on specific features in your product.
+ Don't use the product title as a keyword. The product title is already indexed in searches.
**Note**
Keywords aren't the same as software categories. Keywords are more specific terms that are related to your product.
# Creating AMI and container product usage instructions for AWS Marketplace
As an AWS Marketplace seller, you deliver your products to buyers in different ways. When delivering with Amazon Machine Images (AMIs) and container images, you are responsible for writing usage instructions for them. The following sections provide you with requirements and recommendations about writing usage instructions for these product types.
For more information, see [AMI-based products in AWS Marketplace](ami-products.md).
**Topics**
+ [Requirements](#ami-write-usage-instructions)
+ [Writing release notes](#writing-the-release-notes)
+ [Writing usage instructions](#writing-the-usage-instructions)
+ [Writing upgrade instructions](#writing-upgrade-instructions)
+ [Writing CloudFormation delivery instructions](#ami-cloudformation-delivery)
## Requirements
When creating usage instructions for your product, you must include the following information:
+ Location of all sensitive information saved by customers.
+ Explain all data encryption configuration. Provide detailed instructions on how the user interacts with your application to decrypt necessary data if your application makes use of any encryption techniques.
+ If your product includes cryptographic material, you must include rotation requirements in the usage instruction. Refer to [AMI-based product requirements for AWS Marketplace](product-and-ami-policies.md) for basic requirements for listings that use credentials and cryptographic keys.
+ If any of the data stores in your product are proprietary, provide step-by-step instructions for configuration, backup, and recovery.
+ Step-by-step instructions for how to assess and monitor the health and proper function of the application. For example:
+ Navigate to your [Amazon EC2 console](https://us-east-1.signin.aws.amazon.com/oauth?response_type=code&client_id=arn%3Aaws%3Aiam%3A%3A015428540659%3Auser%2Fec2&redirect_uri=https%3A%2F%2Fus-east-1.console.aws.amazon.com%2Fec2%2Fv2%2Fhome%3Fregion%3Dus-east-1%26state%3DhashArgs%2523Home%253A%26isauthcode%3Dtrue&forceMobileLayout=0&forceMobileApp=0&code_challenge=aRqwDZ0gdWGXfWQgSpY_ge8vSRw2poGnBZ_8qsU5fiA&code_challenge_method=SHA-256) and verify that you're in the correct region.
+ Choose **Instance** and select your launched instance.
+ Select the server to display your metadata page and choose the **Status checks** tab at the bottom of the page to review if your status checks passed or failed.
+ Prescriptive guidance on managing AWS service quotas. For more information see the [AWS General Reference Guide](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html).
+ A pricing breakdown including the cost of running AWS resources added above the standard quota. This can be included in your product usage instructions or linked to [documentation](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) containing detailed information about managing and requesting increased service quotas.
## Writing release notes
Each time you update a product, you must provide a description of the changes in the release notes. The release notes should contain specific information to help the user decide whether to install the update. Use clear labels for the update, such as "Critical" for a security update or "Important" or "Optional" for other types of updates.
## Writing usage instructions
Provide usage instructions that help ensure that the buyer can successfully configure and run the software. The usage instructions you provide are shown during the configuration process.
To write effective usage instructions, follow these guidelines:
+ Assume the user is interested but uninformed.
+ Provide the user with all the information needed to launch and use your product, including any configuration settings and special steps.
Example usage instructions:
1. Launch the product using 1-Click.
1. Use a web browser to access the application at `https:///index.html`.
1. Sign in using the following credentials:
+ User name: `user`
+ Password: the instance ID (`instance_id`)
## Writing upgrade instructions
Provide details on how buyer can upgrade from an earlier version of the product. Include information on how to preserve data and settings when creating another instance. If there is no upgrade path, edit this field to specifically mention that.
Example upgrade instructions:
1. Do \$1\$1\$1\$1, and then \$1\$1\$1\$1.
1. Check that all plugins used by your project are compatible with version \$1.\$1, by doing \$1\$1\$1. If they aren't compatible, do \$1\$1\$1.
1. Make a backup of your data, by doing \$1\$1\$1.
## Writing CloudFormation delivery instructions
When using CloudFormation delivery, you must also include the following:
+ A purpose for each AWS Identity and Access Management (IAM) role and IAM policy created by the CloudFormation template
+ A purpose and location of each key created by the CloudFormation template
+ Network configuration details in deployments involving more than a single element
+ A detailed guide on how your applications are launched and how they're configured to communicate if the deployment includes multiple AWS resources
+ A pricing breakdown that includes the cost of running AWS resources added above the standard limits. Provide prescriptive guidance on managing AWS service limits.
+ All data encryption configuration. For example: Amazon S3 server-side encryption, Amazon Elastic Block Store (Amazon EBS) encryption, Linux Unified Key Setup (LUKS), etc.)
# Optimizing your AWS Marketplace products for search
As an AWS Marketplace seller, you can optimize your products for search so that buyers can more easily find them. Search is a critical tool in the buyer’s journey that enables customers to find the best product to meet their unique needs. For AWS Marketplace customers, searches happen in two primary locations: search engines (for example, Google or Bing) and the search function in AWS Marketplace. This topic provides information on how to optimize your listing for both locations.
**Topics**
+ [Search engine optimization](#keywords)
+ [AWS Marketplace search](#aws-marketplace-search)
## Search engine optimization
Optimizing your product detail page to rank higher for relevant keywords is critical to driving more unique visitors to your product detail page through search engines.
There are three primary page elements that are foundational and impactful for improving organic search to any webpage, including product detail pages: keywords, title tags, and H1 heading tags.
### Keywords
Keywords are a central element to search engine optimization, as they distill topics into focused queries that drive search engine results. The process of identifying the most relevant keywords for your pages involves keyword research. Search engine optimization tools can provide valuable information, such as keyword search volumes (how many times per month a keyword is searched on Google), current rankings, search trends, keyword competitiveness, and related keywords. From this research, you can identify primary and secondary keywords.
Your primary search engine optimization keyword should be a unique single word or phrase that represents the main topic of your page. This primary keyword should be naturally woven into the copy of your product title, short description, and highlight section. Secondary keywords should be highly relevant terms that are found within the remaining page content.
### Title tags
The title tag, which appears in the search engine results pages and as the title of a page in a browser window or tab, informs both readers and search engine web crawlers about the page's content. For AWS Marketplace product detail pages, the product title serves as the title tag, so it’s important to optimize your product titles with search engine optimization keywords to improve ranking potential. To increase the likelihood of achieving a high rank in the search engine results pages, incorporate your brand name, product name, and relevant keywords in your title tag.
### H1 heading tags
H1 heading tags have three roles:
+ They help visitors scan the page contents for the information that they need.
+ They increase accessibility for visitors with visual impairments that use screen readers to understand the page’s content.
+ They provide keywords found in page headings, which receive additional search engine optimization relevance weight if supported by the page content that follows.
## AWS Marketplace search
The AWS Marketplace website ranks the results of search queries using search optimization techniques similar to those used across the industry. By understanding how AWS Marketplace ranks and returns search results, you can create product details optimized for the AWS Marketplace search engine. We recommend taking this guidance into consideration when you create your product detail pages.
### Keywords
During the product creation process, you can submit up to three keywords (single words or phrases) to help customers discover your product through site searches. The keywords text box can contain up to 250 characters.
Use the following tips to create search keywords:
+ Use terms that are relevant so that customers can easily find your products.
+ Choose keywords from your customers' vocabulary—that is, words and phrases that they're likely to use when thinking about your type of product.
+ Create keywords based on specific features in your product.
+ Don't include the product title in the terms that you submit. The product title is already indexed in the search.
**Note**
Keywords aren't the same as software categories. Keywords are more specific terms that are related to your product.
You can edit keywords after you create a product by editing the metadata for the product. For products that you created using the **Products** tab in AWS Marketplace Management Portal, you also use the **Products** tab to make changes. For more information, see [Product changes and updates](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#product-changes-and-updates).
The AWS Marketplace Seller Operations team helps redirect queries with similar-sounding words or words with similar meanings. For example, when customers search for *automobile* when you expect them to search for *car*.
### Software categories
When you list your product, you can choose up to three software categories and corresponding subcategories for your product. This helps customers discover your product as they browse or search the products on AWS Marketplace. Choose only categories that are relevant to your product. In most cases, only one category applies. Both the product load form and the **Products** pages contain a complete list of categories.
**Note**
Categories aren't the same as keywords. The available categories and subcategories are predefined for AWS Marketplace. You decide which of them apply to your product by choosing them from a list. Keywords aren't predefined, but they are created during the process.
### Highlights section
The product details page displays up to three product highlights as bullet points. Customers can search for products by highlights, so include highlights when you create a product. A highlight should describe the product's primary selling points in brief and informative language.
**Example Highlights**
+ Projecting costs: With AnyCompany's product, you pay only for what you use. You're charged for each hour or partial hour that it's running.
### Short description
The product description lists the product's features, benefits, and usage instructions, along with other relevant and specific product information. Keep the following guidelines in mind as you create the product description:
+ Avoid unnecessary capitalization and punctuation marks
+ Don't include redirect information
+ Check spelling and grammar
+ Include only critical and useful information
**Example Short description**
AnyCompany's product automatically distributes incoming application traffic across multiple Amazon EC2 instances. It enables you to improve fault tolerance in your applications by seamlessly providing the load balancing capacity that you need to respond to incoming application traffic. AnyCompany's product detects unhealthy instances in a pool and automatically reroutes traffic to healthy instances until the unhealthy instances have been restored. Customers can enable it in a single AWS Availability Zone or across multiple Availability Zones to enable more consistent application performance.
# Enhance your AWS Marketplace product with promotional media
As an AWS Marketplace seller, you can help customers better discover and evaluate your product by enhancing your product listing with promotional media. Promotional media are videos and images that are shown prominently on your product page and provides customers an easy way of learning about your product. The following sections provide best practices for promotional media and tips for adding and managing promotional media in the AWS Marketplace Management Portal (AMMP).
**Topics**
+ [Best practices for promotional media](#best-practices-promotional-media)
+ [Tips to add and manage promotional media](#promotional-media-tips)
## Best practices for promotional media
Up to five videos and 10 images are supported. Each promotional media item should include a required title and an optional description. Descriptions are used as alt text for media and are highly recommended to improve visual accessibility and search engine optimization.
**Note**
You must have the appropriate rights and permissions to upload or add any promotional media. Media that are added to your product will be made publicly available to all users browsing AWS Marketplace.
**Videos**
This asset type provides you the opportunity to introduce your product and company through a concise overview. You can also include content such as customer interviews, quotes, relevant benefits, and data points. Additionally, videos are a great way to showcase your product through a recorded demo or walk-through, especially for key features or use cases. We recommend videos to be 2-5 minutes in duration, as shorter videos are more impactful.
Specifications:
+ We support direct upload of videos through AMMP or through publicly accessible S3 links.
+ Recommended video resolution is 1080p (1920x1080 pixels) with a preferred 16:9 aspect ratio.
+ Video format must be .mp4 with max file size of 50MB.
+ (Optional) A cover image can be added in place of the auto-generated cover.
+ Cover image should have a resolution of 500x281 pixels (16:9 aspect ratio).
+ Image format must be .png (preferred), .jpg, or .svg without transparency.
**Note**
Externally hosted videos are not directly supported. Public S3 links will be cached by AWS Marketplace during addition and any post-addition changes will not reflect until the media is added again.
YouTube videos are supported with limited capability:
+ If the product video URL field (separate field from promotional media) includes a direct link to a YouTube video, the video will be directly embedded as the last promotional media item if embedding is enabled for the video.
+ Only one product video URL is supported (i.e. only one YouTube video) and re-ordering of the YouTube embedded media is not supported.
**Images**
This asset type provides you an opportunity to promote your product through screenshots and key concept call-outs. Images are ideal to explain complex product features through concise diagrams or flow-charts. Additionally, images can be used to explain pricing tiers and groupings that are not addressable with pricing dimension descriptions.
Specifications:
+ We support direct upload of images through AMMP or through publicly accessible S3 links.
+ Recommended image resolution is 780x439 pixels with a preferred 16:9 aspect ratio. Maximum of 3480x3480 pixels.
+ Image format must be .png (preferred), .jpg, or .svg without transparency.
+ Thumbnails are auto-generated from original source images.
## Tips to add and manage promotional media
**Add media**
+ Promotional media can be added by logging into the [https://aws.amazon.com/marketplace/management/](https://aws.amazon.com/marketplace/management/) and either creating a new product or updating an existing product. The **Images and videos** section is used for adding promotional media and is located within the **Product information** area.
+ While API can also be used to add promotional media, direct upload is only supported through AMMP. Public S3 links are supported in both API and AMMP.
+ Add promotional media in the order you wish the media to display. The first item will be the featured media on the product page.
+ When image asset type is used, the optional cover image is not available. Images will have thumbnails auto-generated once added.
**Update or remove media**
+ Once promotional media is added to a product, the title, description, and cover (if available) can be adjusted as needed by editing the product.
+ Promotional media can be removed once added by clicking on **Delete** for that asset in AMMP prior to submission.
**Order media**
+ By default, new promotional media assets are added to the end of the asset order.
+ To re-order media, delete assets that are out of order and add them again in the right order for submission.