# Uploading Assets & Screenshots

## Screenshots

Screenshots appear on your product page and the first screenshot is used as the thumbnail on marketplace product cards.

### Uploading Screenshots

From the product edit page, scroll to the **Screenshots** section and upload your images. Supported formats: PNG, JPG, WebP.

### Tips for Screenshots

* Use the first screenshot as a strong hero image — this is what buyers see on the marketplace listing before clicking through
* Show the product in action rather than just a logo or placeholder
* Aim for at least 2–3 screenshots that give buyers a clear picture of what they are buying

### Ordering Screenshots

Screenshots are displayed in the order they are uploaded. The first image is always the thumbnail.

***

## Downloadable Assets

Downloadable assets are the files buyers receive after a completed purchase. These can be scripts, archives, documentation, or any other files relevant to your product.

### Uploading Assets

From the product edit page, scroll to the **Assets** section and attach your files. You can upload multiple files.

### Asset Access

Assets are gated — only buyers with a completed order for that product can download them. They are never publicly accessible.

### Updating Assets

You can add or replace assets at any time. When you update a file, all buyers with existing orders gain access to the new version immediately.

### File Recommendations

| Product Type      | What to Upload                                   |
| ----------------- | ------------------------------------------------ |
| One-Time Purchase | Zip archive of the tool or script                |
| Source Code Drop  | Full repo archive with README                    |
| License Key       | Optional: companion documentation or setup guide |
| Subscription      | Current version zip, updated each release        |
| Pre-Sale          | Upload when the product is delivered             |

Keep file sizes reasonable. Very large files may take time to upload and download. For very large codebases consider linking to a private GitHub repo in your product description and using the platform for access gating via license key.


---

# 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/uploading-assets-and-screenshots.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.