Documentation

Template Overrider for Flatsome — Manual

Buyer guide: assign UX Blocks as archive wrappers, loop items, and single layouts. Independent companion plugin — not affiliated with UX-Themes. Requires a valid Flatsome license sold separately.

Open live demo How to try the demo

Requirements

WordPress with Flatsome 3.x active (licensed separately)
UX Blocks available (Flatsome)
Optional: WooCommerce, ACF — for shop archives and custom fields

Install & open settings

Upload the plugin ZIP under Plugins → Add New, then activate it.
Open Settings → Flatsome Template Overrider.
Enable overrides per post type, then pick the UX Blocks to use.

Build the UX Blocks

Each override uses one to three blocks, depending on the surface:

Single — layout for one post / product / CPT item
Archive wrapper — container for the archive (must include {{loop_items}}; add {{pagination}} if you need paging)
Loop item — markup for each entry inside the loop

Optional: per-category wrapper and/or loop item. Category overrides take precedence over the post-type defaults.

Minimal wrapper

<div class="row archive-wrapper">
  {{loop_items}}
</div>
{{pagination}}

Minimal loop item

<div class="col medium-4 small-12">
  <h2>{{post_title}}</h2>
  <img src="{{post_thumbnail:medium}}" alt="" />
</div>

Minimal single

<div class="single-wrapper">
  <h1>{{post_title}}</h1>
  <div>{{post_content}}</div>
</div>

In the wrapper, put only {{loop_items}} for the list area — do not paste the loop-item markup inside the wrapper.

Assign overrides

Open plugin settings and select the post type tab.
Enable the override checkbox.
Choose blocks for single, loop item (if the type has an archive), and archive wrapper.
Save. For categories/taxonomies, pick optional per-term wrappers and loop items, then save each row you change.

On the live demo you can change these assignments with the sandbox user — they reset about every hour.

Common placeholders

Placeholder	Output
`{{post_title}}`	Title
`{{post_excerpt}}`	Excerpt
`{{post_content}}`	Full content (HTML)
`{{post_date}}`	Date
`{{post_author}}`	Author
`{{post_permalink}}`	URL
`{{post_title_link}}`	Linked title
`{{post_thumbnail}}`	Featured image `<img>`
`{{post_thumbnail:medium}}`	Sized image (add `;class=…` as needed)
`{{acf_fieldname}}`	ACF field value
`{{loop_items}}`	Injected loop (wrapper only)
`{{pagination}}`	Pagination (wrapper only)

The plugin’s Placeholders screen lists every registered tag. Conditional shortcodes (fto-if / fto-ifnot) are available for show/hide logic inside blocks.

Live demo

Front: fto-demo.mmcplugins.com
Backend: /wp-login.php — user demo / password demo
Walkthrough: How to try

Sandbox role can edit demo UX Blocks and plugin assignments. Site content and assignments are restored on a periodic reset.

Support scope & legal

Support covers defects in documented features — not custom builds or issues caused only by third-party theme/plugin updates.
Template Overrider for Flatsome does not include Flatsome and is not affiliated with UX-Themes / Envato.
In-plugin legal text: Legal Info.
Contact: support@mmcplugins.com