[name] or [sku], which Omnilinker replaces with the product’s
data. One template serves any number of listings, so a change to it reaches every listing you publish afterwards.
Open Marketplace > Listing templates. You need the Manage listings permission; without it the menu item is
hidden and the page says “You do not have permission to view this page.”
The templates list
The page lists the templates by name, in no particular order. Default marks a default template. Under the name, each template shows the account it belongs to, or All accounts. The list at the top filters the page: All accounts (tenant-wide) shows every template; an account shows that account’s templates together with the all-accounts ones.Create a template
1
Choose the scope
In the list at the top, pick the account the template is for, or All accounts (tenant-wide) for a template every
account can use. You cannot change this later.
2
Open the editor
Click Add template. The New template dialog opens, with the editor on the left and the preview on the right.
3
Name it
Enter a Name, up to 128 characters. Tick Use as default template to make it the default; see
Which template a listing uses.
4
Build the sections
Under Sections, set each section’s type and content; see Sections. Add section adds one at the
end.
5
Check the preview
In Preview against a product, search for a product by name, SKU or GTIN and click it. The preview shows the
template’s text for that product. Click Refresh preview after you change the sections.
6
Save
Click Save. Save is disabled until the template has a name.
Sections
Each section has a type:
The arrows move a section up or down; the bin removes it. A template always keeps at least one section.
Image slot # counts the product’s images in their catalog order, starting at 0: 0 is the first image, 1 the second.
A section whose slot is empty, or higher than the product’s number of images, shows no image.
Text and formatting
The text may use these HTML tags:<h1>, <h2>, <p>, <ul>, <ol>, <li> and <b>. Every other tag is removed but
its text is kept; <script> and <style> are removed with their content. Attributes, such as class or style, are
removed from every tag. Text outside a tag becomes a paragraph per line.
Tokens
Available tokens lists the tokens. Write a token in square brackets; capitals do not matter.[param|…] matches the parameter’s name as the marketplace shows it, ignoring capitals; with no such parameter it gives
nothing. A bracketed word that is not a token stays in the text as it is, brackets included.
What the preview shows
The preview fills the tokens from the product you pick, with two differences from a real listing:[price] shows the
product’s recommended retail price (RRP), or ”—” without one, and [param|…] and [params_list] stay empty, because the
preview has no listing. Image sections do not appear in the preview.
Which template a listing uses
- The template chosen on the listing: in the wizard’s Content step, or in Template in the worksheet’s Details panel. A new draft starts with the template set in the account’s Listing defaults.
- If the listing has none, the listing account’s template marked Use as default template.
- If the account has none, the all-accounts template marked Use as default template.
What the template does at publish
When a listing is published, Omnilinker renders its template for that listing’s product and sends the result as the description:- The description. When the template produces at least one section, it is the whole description, and the Description typed on the listing is not used. When the template produces nothing, or there is no template, the listing’s Description is sent instead.
- The images. When the template places images, the listing gets those images. Otherwise, Omnilinker attaches all the product’s images.
- Live listings. The template is used only at publish. Editing a template does not change listings that are already live; it applies to listings published afterwards.
Troubleshooting
A token appears in the listing as written, with brackets
A token appears in the listing as written, with brackets
The token is misspelled or not in the list. Check it against Available tokens.
An image is missing from the description
An image is missing from the description
Check Image slot #: it starts at 0, and a slot higher than the product’s number of images is skipped. A section
with no slot shows no image.
The listing's own description was not used
The listing's own description was not used
The listing has a template, or the account has a default template, that produces at least one section. Then the
template is the description. Remove the text from the template, or put the text in the template.
“The listing template could not be rendered: …”
“The listing template could not be rendered: …”
Omnilinker could not read the template’s sections. Open the template, check its sections, and save it again.
OLX rejects the description as too short
OLX rejects the description as too short
OLX needs at least 80 characters. Add text to the template, or, without a template, write a longer Description
on the listing.
Permissions
Create listings
Choose a template while you create and publish listings.
Category and attribute mapping
Fill the parameters that
[params_list] prints.Products
Keep the product data and images the tokens read.
Manage listings
Follow listings once they are published.