# 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](https://docs.darcyiq.com/integrations-and-configuration/integration-overview) |
| **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 %}