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
- Open the listing.
- Click the actions menu (...) in the top right and choose Add Notes (or Edit Notes if the listing already has some).
- 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 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.