Skip to main content
Documentation/Templating/Single Templates
Templating

Single Templates

A single template is a layout for one piece of content at a time — a blog post, a page, a
product, any custom post type item. (Lists of content are the other half of the job; see
Archive Templates.) You design it once against the
shape of that content, and every matching item renders through it with its own title,
image and fields.

Creating a single template

  1. In wp-admin, go to Oxygen → Templates and click Add Template.
  2. Oxygen shows a short warning about reading the documentation before creating custom
    templates — click Continue.
  3. Give it a Title, and set Location to the content it should apply to — Posts
    for a blog post layout, or any other entry from the Single group below.
  4. Optionally add Conditions to narrow it further, then click Add template.
The Add template dialog with Location set to Posts

The template starts empty. Click its name in the list to open it in the builder.

Locations for single content

The Single group of the Location dropdown holds
every target for individual content:

Location Matches
All Singles Any singular view at all: posts, pages, media attachments, and every custom post type item.
A specific post type Posts, Pages, Media, and every public custom post type you've registered — each appears in the list automatically.
Front Page Whatever WordPress is serving as the site's front page, whether that's the posts index or a static page.

Dynamic Data

Nothing in a single template should name a specific post. Every element that varies is
bound to a data source instead, and resolves against whichever item is being rendered: a
Heading bound to the post title, an Image bound to the featured image, Text bound to a
custom field, plus the author, publish date and taxonomy terms from the same picker.

That binding is what makes one template serve a hundred posts. See
Dynamic Data.

A heading in a single template bound to Post Title, the binding shown as a token in the properties panel

Use the Preview post picker in the builder toolbar to swap which real item fills the
canvas while you design. Switching it refills every binding with that item's data, which
is the fastest way to catch a layout that only works for your longest title or your one
post that has a featured image.

Template Content Area

Dynamic data covers everything the template can pull from the database. When you want part
of the page to stay designable in Oxygen per item — a free-form middle that whoever edits
that post lays out themselves — add a Template Content Area instead.

It marks the spot where the item's own content renders. Open any item the template applies
to, and the area the Template Content Area covers is editable there, while the frame around
it stays in the template.

A Template Content Area in a template, with the surrounding frame elements around it on the canvas

One per template. See
Template Content Area.