# Add Notes to a Listing

> Leave a short note on a listing so your team and Osello's AI both know the context behind it, and find listings later by what the note says.

Every listing has a **Notes** field: a free-text place to record what someone working on that listing next would need to know. Notes stay inside Osello — they are never sent to the marketplace — and they are searchable.

## Add or edit notes

1. Open the listing.
2. Click the actions menu (**...**) in the top right and choose **Add Notes** (or **Edit Notes** if the listing already has some).
3. Type your note and click **Save notes**.

Once a listing has notes, a notepad icon appears next to its state badge at the top of the page. Hover it — or tap it on a phone — to preview the note, then click **View / edit notes** in the preview to open the same dialog.

Notes support **Markdown**, so you can use bold, bullet lists, links and headings. The editor has a formatting toolbar, and you can switch it to plain Markdown source with the toggle in its top-right corner — the same editor, and the same toggle, you get on the AI instructions fields. (Which one opens first follows the **Markdown editor** setting on your preferences page.)

A note can be up to 10,000 characters; a counter appears as you get close to the limit. Any raw HTML you paste in is stripped out.

To clear a note, empty the box and save.

## Who can see them

Notes live only inside Osello. They are never sent to the marketplace, never shown to shoppers, and never included in what you submit to a channel.

Inside Osello, anyone who can open the listing can read and edit its notes — every user on your store, and the AI agents working on your listings. There is no per-person or per-role restriction, so treat a note as something the whole team can see. Don't put passwords, customer personal information, or anything else confidential in one.

## Add notes while disabling a listing

Disabling is usually when the reason is worth writing down, so the **Disable** dialog has the same **Listing notes** box, pre-filled with whatever is already there. Edit it and confirm, and the note is saved along with the disable.

The box edits the listing's notes rather than adding a line to them, so trim anything that's no longer true while you're in there.

## Find listings by their notes

The search box on the **Listings** page matches notes as well as SKU, style code, external ID, and title — so searching for `corrected sizing` returns every listing whose notes mention it. Matching is on any part of the note, so a few distinctive words are enough.

Because of that, a note is also a way to tag a listing with something Osello has no field for — an internal reference, a supplier code, a project name — and then find every listing carrying it. **Use this sparingly.** Notes are meant to be read by people, and a note that is mostly machine-ish tags stops being useful as a note. If you find yourself doing it across many listings, it's usually a sign the value belongs somewhere more structured — talk to us about it.

## What to put in a note (and what not to)

Good notes are short and durable — facts that stay true and save the next person a discovery:

- "Runs a size small. Sizing chart is the vendor's, not the brand's."
- "The marketplace rejected the old hero image for a visible logo."
- "Keep this live through December at the customer's request."

Two cases where a note is especially worth writing:

- **When a listing deliberately breaks one of your conventions.** If this listing's SKU, style code or title doesn't follow the pattern you use everywhere else, say why in a note. Otherwise the next person to look at it — or the next agent — reads it as a mistake and "fixes" it.
- **When a marketplace has granted you an exception.** If a channel signed off on something it would normally reject, such as letting you phrase a title a particular way, record that along with who approved it and when. It saves re-litigating the same point on the next submission.

Two things don't belong in notes:

- **A log of changes.** Every edit to a listing is already recorded, with who made it and when, on the listing's history. Notes that duplicate that quickly bury the lines worth reading.
- **Anything sensitive.** See [Who can see them](#who-can-see-them) above — everyone on your store, and the AI agents, can read a listing's notes.

Editing notes never changes a listing's state. A listing that is ready, submitted, or live stays exactly where it was — notes are not marketplace data, so changing them won't mark the listing as having unsubmitted changes.

## Osello's AI reads and writes them too

When an AI agent works on a listing, it is given that listing's notes as context and is asked to add to them when it learns something durable that isn't recorded anywhere else — a rejection reason, a constraint that isn't in your source data, a decision you made. It's told to keep them succinct and never to use them as a change log.

You can ask an agent to write a note directly ("note that this vendor's sizing runs small"), and you can edit or delete anything an agent wrote the same way you edit your own.

## Where to go next

- [Enable, Disable, and Schedule Listings](/help/channels-listings/enable-disable-and-schedule-listings)
- [Fix Rejected Listings](/help/channels-listings/fix-rejected-listings)
- [Submit Listings and Track Status](/help/channels-listings/submit-listings-and-track-status)