You are here: Administrators Reference > Site Administration > Elements & Forms > Elements > Add Display Template

Add Display Template

Use the Add Display Template dialog to define a layout for Custom Element data. The dialog displays in edit mode for existing Elements and has three tabs, as shown below, for easily creating layouts and conveniently saving changes when switching between edit and preview modes.

Access this dialog from the Site Administration dashboard. Expand Elements in the left panel, click Elements & Forms to display the Manage Elements dialog, then click a Layouts link for a selected Custom Element. From the Manage Layouts dialog, click the edit icon to view or change an existing Display Template, or click Add Display Template to create a new layout.

You can also access this dialog from the Element menu Choose Layout option at the page level. See the Elements Reference for details.

Edit Tab

Use the Edit tab to format your layout using the Rich Text Editor. You can add a combination of HTML and form field value placeholders to build up the display template for the Custom Element. In this mode, the Rich Text Editor operates just like the standard mode used for the Formatted Text Block Element. Any HTML can be added into the block for presentation to the client browser.

Template Name: Required. Enter a name.

Template Description: Optionally describe this template.

Private: Optionally show/hide this template to other CommonSpot users.

Preview Image: Optionally include an image to show on mouseover for this template in Manage Layouts. Displays the pathname of the current image, if any. Clicking Clear removes the current image. Clicking Select displays the Choose Image dialog for selecting or uploading a new preview image.

Template: Use the Rich Text Editor controls to enter fields, labels, and formatting.

Click Save to keep your changes and optionally preview the template for contributors or site visitors. Click Save & Close to keep your changes and exit, or click Close to exit without saving.

Sample Data Tab

Use the Sample Data tab to see the form as end users see it when entering data for an instance of the Custom Element and to preview fields populated with data, as shown below for the Job Detail display template.

Preview Tab

Use the Preview tab to see how the Display Template will appear to site visitors.


Related Links

You can download PDF versions of the Content Contributor's, Administrator's, and Elements Reference documents from the support section of (requires login).

For technical support: