> For the complete documentation index, see [llms.txt](https://docs.nifty.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nifty.ai/crosslisting/ai-listing-generator.md).
# AI Listing Generator
Nifty's AI can create complete multi-marketplace listings from photos alone — generating titles, descriptions, categories, and item specifics automatically.
### Where to find it
To generate a single set of listings, go to the [**Inventory Manager**](/inventory-management/inventory-manager.md) and click **Add item** or **Edit item** (see [Creating and Editing Items](/crosslisting/creating-and-editing-items.md)). Click **Generate Listing** in the purple section below the photos.
To generate multiple sets of listings at once, go to the [**Inventory Manager**](/inventory-management/inventory-manager.md) and click **Bulk Generate** (top right). On mobile, this appears as a button with a purple lightning bolt.
### How it works
1. Upload photos of your item.
2. Select up to 8 photos for AI analysis.
3. AI analyzes the images and fills in:
* Title (optimized for search).
* Description (customizable style).
* Price (when recent comparable sales are available).
* General details: condition, colors, style tags.
* Marketplace-specific details: category, brand, size, specifics.
4. Review and edit the generated content.
5. Publish when ready.
The AI uses your photos to fill out all the relevant details. Better photos = better results.
**No setup required** — just upload photos and click Generate. The sections below explain optional ways to customize.
### Custom instructions
Want more control? Go to Settings → [**AI Generation**](https://app.nifty.ai/settings/ai-generation) to customize how the AI writes your listings. This is optional — the AI works well with no configuration.
#### Using snippets
Not sure where to start? Use the snippet buttons to insert pre-built templates, then customize them. Snippets are just starting points — edit or delete any part.
Available snippets:
* **Title** — Customize what goes in your title and in what order
* **Description** — Start your descriptions with a short paragraph about the item
* **+ Tone** — Set the writing style (friendly, professional, etc.)
* **+ Occasions** — Suggest when or where to use the item
* **+ Item specifics** — Add a list of details after the paragraph
* **+ Keywords** — Add search terms after the paragraph
* **Condition** — Set a default when condition isn't obvious from photos
#### How your instructions work with the defaults
Every field the AI writes (title, description, condition, SKU, condition description) has a default. Your instructions take priority over the defaults, and the defaults stay for anything you leave out.
* **To add to a field**, describe what you want and where it goes, for example "After the paragraph, add a section with 10-15 keywords." The AI keeps the rest of the default.
* **To drop or change part of a default**, say so directly, for example "Skip the introductory paragraph" or "Keep titles under 60 characters."
When something matters to you, say it plainly. The AI follows clear instructions more reliably than it guesses.
**Example: the description.** Without instructions, every description opens with a short paragraph about the item. A **Measurements** section follows when your photos show measurements. The AI doesn't mention size or condition unless you ask.
| If you want... | Write... |
| ---------------------------- | ----------------------------------------------------------- |
| No paragraph | "Don't write a paragraph. Only include: ..." |
| A sentence about condition | "Include a sentence about the item's condition" |
| Your sections in a set order | "Put measurements first, then the paragraph, then keywords" |
#### Writing your own instructions
You can write custom instructions in plain English. Be specific about what you want:
| Instead of... | Try... |
| ----------------- | ----------------------------------------------------------------------------- |
| "Make it short" | "Keep descriptions under 500 characters" |
| "Add keywords" | "After the paragraph, add a section with 10-15 SEO keywords, comma-separated" |
| "Be professional" | "Use a friendly but professional tone, no emojis" |
For longer instructions, organize by section — the AI follows structured formatting best:
```
Title:
[your title instructions]
Description:
[your description instructions]
Condition:
[your condition instructions]
```
{% hint style="info" %}
**Tip:** Writing good instructions is an art, not a science — expect to experiment. Try using an LLM like ChatGPT or Claude to help you draft and iterate. Describe what you sell and the style you want, then ask it to write instructions you can paste into Nifty.
{% endhint %}
#### Description footer
Add a personal touch that appears at the end of every description — like "Thanks for shopping secondhand!" or your return policy.
### Tips for best results
* **Clear, well-lit photos:** AI can only identify what it can see.
* **Include labels showing brand, size, and any identifiers:** AI is able to read text and look up the RN (Registered Identification Number).
* **Select a department:** For unisex items like jeans, selecting the department (men, women, kids) upfront will steer the AI in the right direction.
* **Include additional info:** Mention anything the AI can't see — like flaws or details you want included. The AI will incorporate them naturally.
* **Multiple angles:** Front, back, notable details.
* **Measurements:** Write measurements on a card, or include a photo with a ruler or tape measure — the AI reads both accurately.
### Rating a generation
After you generate a listing, a **How did it do?** prompt appears above the **Generate again** button when you reopen the item. Click the thumbs up or thumbs down to rate it. A thumbs down lets you pick what went wrong (for example, **Wrong brand** or **Made-up details**) and add a note for our team to review.
### Smart Credits
Each AI generation uses 1 **Smart Credit**. See [**Smart Credits**](/crosslisting/smart-credits.md) for details on costs and monthly allocations.
### Limitations
| Limitation | Details |
| ----------------- | ---------------------------------------------------------------- |
| Enhance your text | AI won't improve words you've already written — it replaces them |
| Learn your style | AI doesn't learn from your previous listings |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.nifty.ai/crosslisting/ai-listing-generator.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
