Merge fields: build one design that fills in every item's details

Merge fields let you build one listing design once, then have it fill itself in with the real title, photos, specifics and description of whichever item you apply it to. This article covers every merge field token available in the designer’s Fields tab, what each one becomes when you generate a listing, and where the feature falls short.

What merge fields do

A merge field is a placeholder token you drop into your design, such as {title}. It stays as a placeholder while you are designing. The moment you apply the design to an actual item and generate the listing, DashVue swaps every token in it for that item’s own data. Build the layout once and reuse it across as many listings as you like, each one filled in with its own details automatically.

The fields you can drop in

These are the tokens available on the Fields tab of the listing designer. Click one to insert it at your cursor.

• {title}: the item’s listing title.
• {description}: the item’s own description text.
• {photos}: the item’s full set of photos, laid out automatically as a gallery.
• {image[n]}: one specific photo by position, for example {image[1]} for the first photo or {image[2]} for the second. Use this when you want to place individual photos into specific slots in your design rather than dropping in the whole gallery at once.
• {specifics}: the item’s full block of item specifics (things like Brand, Size, Colour), formatted automatically.
• {itemspecific[...]}: a single named item specific pulled out on its own, for example {itemspecific[Brand]}, if you want just one value rather than the whole specifics block.
• {condition_description}: the item’s condition notes.
• {{store_name}}: your shop name (note the double braces, which mark it out from the single-brace item fields above).
• {more_items}: a grid promoting other listings from your account, for cross-selling. See the limit on this one below.

Building a design with merge fields

1. Open your design in the listing designer and go to the Fields tab.
2. Place your cursor, or select the element, where you want a piece of real listing data to appear.
3. Click the token you need. Use {photos} for a full automatic gallery, or a series of {image[n]} tokens if you want specific photos in specific positions in your layout.
4. Add {specifics} for a complete specifics table, or use one or more {itemspecific[...]} tokens if you only want a couple of named values shown prominently.
5. Drop in {title}, {description}, {condition_description} and {{store_name}} wherever your layout calls for them.
6. Save the design once it looks right. From then on, applying it to any item and generating the listing swaps every token for that item’s real details, no manual retyping needed.

Cross-selling with more items

The {more_items} token adds a grid of other listings to the bottom of your design, so buyers see more of what you sell while they are looking at one item.