# AWS Marketplace (Beta)

{% hint style="warning" %}
**BETA**: AWS Marketplace management is currently in beta. Features and workflows may change as we refine the experience based on user feedback.
{% endhint %}

Manage your AWS Marketplace product listings and offers directly from DarcyIQ. **Create listings, generate offers, and monitor your marketplace portfolio** — all with AI assistance to optimize your go-to-market strategy.

## Overview

The AWS Marketplace page gives you a centralized view of all your marketplace products across connected AWS accounts, with tools to create, manage, and optimize listings without switching to the AWS Console.

| Feature                   | Capability                                 | Business Impact                  |
| ------------------------- | ------------------------------------------ | -------------------------------- |
| **Product Dashboard**     | View all listings with stats and filtering | Full portfolio visibility        |
| **Multi-Account Support** | Switch between AWS accounts                | Manage all accounts in one place |
| **Listing Creation**      | Create new marketplace products            | Faster time to market            |
| **Offer Management**      | Create private and public offers           | Streamlined deal flow            |
| **AI Chat Assistance**    | Darcy Chat for marketplace strategy        | Optimized listings and pricing   |

## Dashboard

### Statistics Panel

At-a-glance metrics for your marketplace portfolio:

| Metric                    | Description                             |
| ------------------------- | --------------------------------------- |
| **Total Products**        | Number of products across all types     |
| **Total Offers**          | Combined offers across all products     |
| **SaaS Products**         | Count of SaaS product listings          |
| **Professional Services** | Count of professional services products |

### Product Table

Browse and manage all marketplace entities with sortable columns:

| Column            | Information                              | Sortable |
| ----------------- | ---------------------------------------- | -------- |
| **Name**          | Product listing name                     | Yes      |
| **Type**          | Entity type (SaaS, AMI, Container, etc.) | Yes      |
| **Entity ID**     | Unique AWS Marketplace identifier        | Yes      |
| **Offers**        | Number of associated offers              | Yes      |
| **Visibility**    | Draft, Limited, or Public                | Yes      |
| **Last Modified** | Most recent update date                  | Yes      |

### Filtering and Search

| Filter          | Options                                               | Purpose                     |
| --------------- | ----------------------------------------------------- | --------------------------- |
| **AWS Account** | All connected accounts                                | Scope to a specific account |
| **Entity Type** | SaaS, AMI, Container, Data, ML, Professional Services | Filter by product category  |
| **Search**      | Free-text search                                      | Find by name, ID, or type   |

## Supported Product Types

| Type                              | Icon   | Description                      |
| --------------------------------- | ------ | -------------------------------- |
| **SaaS Product**                  | Blue   | Software-as-a-Service listings   |
| **AMI Product**                   | Green  | Amazon Machine Image products    |
| **Container Product**             | Purple | Container-based deployments      |
| **Data Product**                  | Orange | Data exchange products           |
| **Machine Learning Product**      | Pink   | ML model and algorithm listings  |
| **Professional Services Product** | Indigo | Consulting and services listings |

## Creating Listings

Create new AWS Marketplace product listings directly from DarcyIQ.

{% stepper %}
{% step %}
**Select Account** Choose the AWS account where you want to create the listing.
{% endstep %}

{% step %}
**Choose Product Type** Select the appropriate entity type (SaaS, AMI, Container, Professional Services, etc.).
{% endstep %}

{% step %}
**Configure Details** Fill in product name, description, and entity-specific configuration.
{% endstep %}

{% step %}
**Submit for Review** The listing is submitted to AWS Marketplace as a change set. New listings start in **Draft** visibility.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
New listings are created in **Draft** status. You must complete all required fields and submit for AWS review before the listing becomes publicly visible.
{% endhint %}

## Managing Offers

Create private or public offers for your published products.

| Offer Type        | Description                       | Use Case                         |
| ----------------- | --------------------------------- | -------------------------------- |
| **Public Offer**  | Available to all AWS customers    | General availability             |
| **Private Offer** | Targeted to specific AWS accounts | Custom pricing, enterprise deals |

### Creating an Offer

1. Find the product in the dashboard
2. Click the actions menu and select **Create Offer**
3. Configure offer terms, pricing, and buyer details
4. Submit the offer for processing

{% hint style="warning" %}
Offers can only be created for products that are **not** in Draft visibility. Publish your listing first before creating offers.
{% endhint %}

## AI Agent for Marketplace Management

DarcyIQ's AI Agent isn't just an advisor — it can directly manage your AWS Marketplace listings through natural conversation. Click **Darcy Chat** from the marketplace page or any listing detail view, and the agent has full context of the product you're viewing.

{% hint style="success" %}
**Talk, Don't Click**: Instead of navigating forms and fields, just tell the agent what you want. "Update the description to emphasize our SOC 2 compliance" or "Create a private offer for Acme Corp at $5,000/year" — and the agent executes it directly against the AWS Marketplace Catalog API.
{% endhint %}

### What the Agent Can Do

The marketplace agent is context-aware — when you open it from a listing detail page, it automatically knows which product you're working with.

| Capability               | What You Can Say                                             | What Happens                                                          |
| ------------------------ | ------------------------------------------------------------ | --------------------------------------------------------------------- |
| **Update Product Info**  | "Change the title to 'CloudMigrate Pro'"                     | Updates title, short/long descriptions, logo URL, or support info     |
| **Manage Categories**    | "Set categories to Data Analytics and Security"              | Updates AWS Marketplace categories (validates against official list)  |
| **Update Keywords**      | "Add keywords: migration, cloud, compliance, AWS"            | Sets search keywords for marketplace discoverability                  |
| **Edit Highlights**      | "Update highlights to focus on speed and security"           | Updates the product highlight bullets shown to buyers                 |
| **Configure Pricing**    | "Add a pricing dimension for 100 users at $500/month"        | Adds or updates pricing dimensions and terms                          |
| **Set Up Delivery**      | "Add a SaaS fulfillment URL"                                 | Configures delivery and fulfillment options                           |
| **Create Offers**        | "Create a private offer for account 123456789012 at $10,000" | Creates private offers with buyer details, pricing, and validity      |
| **Update Legal Terms**   | "Update the EULA for this offer"                             | Modifies legal terms on offers                                        |
| **Update Support Terms** | "Set support to 24/7 email with 4-hour response time"        | Configures support terms on offers                                    |
| **Configure Targeting**  | "Target this offer to specific AWS accounts"                 | Sets positive/negative targeting for offers                           |
| **Add Instance Types**   | "Add m5.large and c5.xlarge to the AMI product"              | Adds supported instance types (AMI products)                          |
| **Analyze Listing**      | "Analyze this listing and tell me what's missing"            | Runs a completeness audit with a score, issues, and recommendations   |
| **Check Change Status**  | "What's the status of my last update?"                       | Checks whether a change set succeeded, failed, or is still processing |
| **List Offers**          | "Show me all offers for this product"                        | Lists all associated offers with status and details                   |

### Example Workflows

**Preparing a new listing for publication:**

```
You: "Analyze this listing and tell me what I need to fix"
Agent: Shows missing fields, invalid categories, and a completeness score

You: "Write a compelling long description for a cloud migration SaaS tool"
Agent: Generates description and updates it directly

You: "Set categories to Migration and Security, add keywords for cloud migration"
Agent: Updates categories and keywords in one go

You: "Add 5 highlights focusing on speed, security, and compliance"
Agent: Creates and submits the highlights
```

**Creating a private offer for a customer:**

```
You: "Create a private offer for Acme Corp, account 987654321012, 
      at $25,000/year with a 60-day acceptance window"
Agent: Creates the offer and returns the change set ID

You: "Check the status of that change set"
Agent: Reports whether the offer is live or still processing
```

### Validation and Safety

The agent validates all inputs before submitting to AWS:

| Validation            | Rule                                                  |
| --------------------- | ----------------------------------------------------- |
| **Product Title**     | Max 120 characters, cannot be empty                   |
| **Short Description** | Max 200 characters                                    |
| **Long Description**  | Max 2,000 characters (supports Markdown)              |
| **Logo URL**          | Must be a public HTTPS URL                            |
| **Categories**        | 1–3 categories from the official AWS Marketplace list |
| **Keywords**          | At least 1 required                                   |
| **Highlights**        | At least 1 required                                   |

If something doesn't meet AWS requirements, the agent will tell you what to fix before submitting.

## Product Detail View

Click any product row to navigate to its detail page. The detail view is organized into tabs:

| Tab              | Capabilities                                                                                           |
| ---------------- | ------------------------------------------------------------------------------------------------------ |
| **Information**  | View and edit product title, descriptions, logo, categories, keywords, highlights, and support details |
| **Pricing**      | Configure pricing dimensions and terms                                                                 |
| **Fulfillment**  | Manage fulfillment URLs and delivery options                                                           |
| **Architecture** | Review and update architecture configuration                                                           |
| **Offers**       | View all offers associated with this product and create new ones                                       |

Darcy Chat is also available from the detail view with full context of the current listing.

## Multi-Account Management

If you have multiple AWS accounts connected, you can switch between them using the account selector at the top of the page. DarcyIQ remembers your last selected account.

| Feature                   | Behavior                                               |
| ------------------------- | ------------------------------------------------------ |
| **Account Selector**      | Dropdown showing all connected AWS accounts            |
| **Persistent Preference** | Your last selected account is remembered               |
| **Per-Account Data**      | Products and offers are scoped to the selected account |

## AWS Console Integration

For operations that require the full AWS Console, click **View in AWS Console** from any product's action menu to jump directly to that listing in the AWS Marketplace Management Portal.

## Getting Started

### Prerequisites

| Requirement                 | Details                                                                                                        |
| --------------------------- | -------------------------------------------------------------------------------------------------------------- |
| **AWS Account Integration** | Connect at least one AWS account under [Integrations](/integrations-and-configuration/integration-overview.md) |
| **Marketplace Permissions** | Your AWS account must have AWS Marketplace Catalog API access                                                  |
| **IAM Permissions**         | Appropriate IAM role with `aws-marketplace:*` and `catalog-marketplace:*` permissions                          |

### Connecting Your Account

1. Navigate to **Integrations** > **AWS Ecosystem** > **AWS Accounts Integration**
2. Connect your AWS account with marketplace permissions
3. Visit the **AWS Marketplace** page from the Partner navigation
4. Select your account and start managing listings

## Best Practices

| Practice                        | Why It Matters                                                    |
| ------------------------------- | ----------------------------------------------------------------- |
| **Complete all listing fields** | Thorough listings get approved faster by AWS                      |
| **Use Darcy Chat for copy**     | AI-generated descriptions are optimized for marketplace search    |
| **Start with Draft**            | Perfect your listing before making it public                      |
| **Monitor change sets**         | Track submission status to catch issues early                     |
| **Create private offers first** | Test your pricing model with select customers before going public |

{% hint style="info" %}
**Pro Tip**: Use the Darcy Chat assistant to generate product descriptions and marketing copy. It has context on your full marketplace portfolio and can help you craft compelling, search-optimized listings.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.darcyiq.com/partner/aws-marketplace.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.