What is an advisory suggestion?
An advisory suggestion is a proposed value that the receiving application may apply, edit or ignore; it changes nothing by itself.
In plain words: An advisory suggestion is an offer, not an action. A service proposes a category or an attribute value, and the application that asked decides whether to use it, change it or drop it. Nothing is saved or published until that application does it.
Published by Youzu · Editorial policy
- Published
Why it matters
In a seller form, a suggestion saves typing, but the seller or the marketplace stays responsible for what is published. Keeping the suggestion separate from the save step keeps that responsibility clear and lets a form show the proposal as something to check.
How it works
Ask
The form sends the data it has, such as a title and photos, and asks for suggestions.
Show
The form shows each proposed value as a chip or a pre-filled field that can be edited.
Decide
The seller or the application accepts, edits or ignores it, and only then saves.
| Step | Service | Your application |
|---|---|---|
| Propose | Returns a value | Receives it |
| Review | Nothing | Shows it for a check |
| Save and publish | Nothing | Owns both steps |
Examples
A suggested color
The form suggests 'olive' for the jacket.
A suggested category
A category for the sofa is suggested.
A suggestion ignored
A suggested condition for a used chair does not match what the seller knows.
Common mistakes
Saving without review. Applying every suggestion automatically turns advice into a decision no one made.
Hiding the save step. Putting the save button inside the suggestion box makes accepting look like the only way forward.
Related terms
- Listing quality
- How complete, consistent and policy-compliant a listing is, judged from its text, attributes, images and category.
- Attribute extraction
- Pulling structured values such as color, material or size out of text or images and storing them as fields on a product record.
- Typed attribute
- A typed attribute stores a value in a defined type, such as a number with a unit, a yes/no value or a choice from an allowed list.
In Youzu
Youzu helps marketplaces, classifieds and retailers turn raw seller and supplier product data into structured, reviewable catalog records.
Sources
Understanding Success Criterion 3.3.4: Error Prevention (Legal, Financial, Data), W3C. w3.org/WAI/WCAG22/Understanding/error-prevention-legal-financial-data.html. Accessed .
Merchant API v2 reference, Youzu documentation. docs.youzu.ai/docs/catalogue/merchant-api-v2. Accessed .
FAQ
Questions buyers ask
No. Merchant API calls are advisory: they do not create, update or publish products; your application decides what to apply and owns saving and publishing. A suggestion is only a proposal until your application saves it, so your catalog changes when you decide it should.
It returns proposed values for a listing, such as a category or attributes, for your form to show. The Merchant API reference on docs.youzu.ai lists what each call returns, so check that page for the current list rather than relying on a summary here.
Merchant API access depends on your plan, a ready catalog and a monthly request quota. Confirm your plan, your catalog state and your quota with the Youzu team before you build a form on it, so a seller never meets a refused call.
Last reviewed
Related
Keep reading
Product
Listing quality, checked before search
Check listings before search: unsupported attributes stay empty, title and image mismatches raise a warning and your rules flag what is out of policy.
Glossary
What is listing quality?
Listing quality defined in plain words, with a worked example, common mistakes and links to the guides and Youzu products that apply it.
Guide
Designing a seller listing flow that produces clean data
How to design a marketplace listing flow that collects the minimum, suggests the rest and validates before publishing: photos, category, attributes, draft.