Custom Elements Overview
You are here: Elements Reference > Custom Elements > Custom Elements Overview


Custom Elements Overview

Custom Elements are user-defined, self contained content objects that are built and managed by the site administrator. Similar to Metadata forms or Simple Forms, custom Elements are a collection of user defined fields. The fields of a custom Element can be any of the two dozen plus built-in field types (for example, text-area, checkboxes, selection-list, image, mail, etc.) or a custom field type built for your specific needs by a developer.

Note: You must create the Custom Element within the Site Administration Dashboard before you can insert it into a page. After you create the Element, you can select it from within the Element Gallery. It will reside in the category to which it was assigned when you created it.

Unlike a collection of Elements on a page, custom field types are self contained. The end-user contributor edits the Custom Element object as a form, providing all of the data, as required by the Element creator. Fields can be set to be required, can have default values, and can be secured as to only allow certain users to edit or view the field.

Custom Elements also provide two “rendering modes”. One mode will display the current Element data and the other will allow for the display of one or more Custom Element data records based on a particular filter or via manual selection. This allows for the reuse of content within a site. For example, you might create an event object and have a calendar view of multiple events or a detailed view of a particular Element.

Refer to Selecting Rendering Mode for more information about the options available for rendering Custom Element content.

Custom Elements can be rendered using Display Templates or Custom Properties.

To learn more about rendering Custom Elements, refer to the Controlling Custom Element Rendering (Display Templates) rendering section of this dialog.

Custom Elements come in two similar but unique styles: Local and Global. Each style contains all of the same features except Local Custom Elements can be versioned because they are bound to a page.

To understand more about the similarities and differences, refer to the Custom Element Types section in this guide.

An additional method for populating Custom Elements is by using the Simple Form. This allows anonymous users the ability to add content for Custom Elements. This can be a great method for large data entry situations.

Refer to the Using Simple Forms for Data Entry into Custom Elements for more information about this topic.


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: