# Creating a Product Listing

Once your vendor account is approved you can create product listings from your vendor dashboard.

## Starting a New Listing

Go to **Vendor Dashboard → Products → New Product**.

## Required Fields

| Field            | Description                                                   |
| ---------------- | ------------------------------------------------------------- |
| **Title**        | The product name shown on the marketplace                     |
| **Slug**         | URL-friendly identifier (auto-generated from title, editable) |
| **Category**     | The marketplace category your product belongs to              |
| **Product Type** | How the product is delivered and licensed                     |
| **Description**  | Full markdown description (minimum 10 characters)             |
| **Price**        | Set in USD cents (fiat) and/or USDC                           |

## Optional Fields

| Field                     | Description                                                  |
| ------------------------- | ------------------------------------------------------------ |
| **Short Description**     | One-line summary shown on product cards (max 500 characters) |
| **Demo URL**              | Link to a live demo or video                                 |
| **Current Version**       | Version string shown on the product page                     |
| **Subscription Interval** | Days between renewals (subscriptions only)                   |
| **Pre-sale End Date**     | When the pre-sale closes (idea/pre-sale type only)           |

## Pricing

You can set a fiat price (stored in cents), a USDC price, or both. At least one must be set before publishing. See [Pricing: Fiat vs. USDC](/vendors/pricing-fiat-vs-usdc.md) for guidance.

## Screenshots

Upload screenshots to give buyers a visual preview of your product. The first screenshot is used as the thumbnail on product cards. See [Uploading Assets & Screenshots](/vendors/uploading-assets-and-screenshots.md).

## Downloadable Assets

Attach the files buyers receive after purchase — scripts, zips, source archives, or documentation. These are only accessible to buyers who have completed payment.

## Saving and Publishing

Products are saved as **Draft** by default. A draft is not visible on the marketplace. When you are ready to go live, change the status to **Published**.

You can also **Archive** a product to hide it from the marketplace without deleting it.


---

# 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.blocksmiths.tech/vendors/creating-a-product-listing.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.