Is this really the version you are looking for? Kentico Xperience 8.2 Documentation is no longer updated. Use the switcher in the header to choose your product version.
Widgets are page components that display content or provide some type of functionality. By adding widgets, you can create advanced web content on your pages. Widgets give you much more power and flexibility than editing text and images.
For example, widgets allow you to:
Kentico contains a set of widgets by default. The developers of your website can also prepare additional widgets with any required functionality.
You can add widgets on pages where the website's developers have prepared editor widget zones. The developers determine the following for each page:
To work with the content of widget zones, edit pages on the Page tab of the Pages application. Here you can see editor widget zones surrounded by dotted outlines.
Important: Changes that you make to editor widgets are temporary until you Save the page. Applies to all actions: adding, configuring, moving and deleting widgets.
Editor widgets and workflow
The content of editor widget zones is included within the scope of workflow:
Note: Workflow does NOT apply to Content personalization or Multivariate testing variants of widgets. Changes made to editor widget variants can have an immediate effect on the live website, and are not included in the page version history.
To add a widget to a zone:
Open the zone's menu ().
Click Add new widget.
Select a widget from the catalog (you can only choose widgets that are allowed for editor zones).
Click Select.
Set the properties of the widget.
Click OK.
Click Save to confirm the change to the page's widget content.
To edit the properties of existing widgets on the page:
For security reasons, the system does NOT resolve macro expressions placed into the values of widget properties in the configuration dialog.
To move a widget between zones on the page or to a different position in the same zone:
Copying allows you to duplicate editor widgets and paste them into any editor zone, including other pages on the same website.
You can copy:
The system saves the widgets and their configuration into an internal "clipboard". To paste the copied widgets:
Navigate to the target editor widget zone:
Place the copied widgets:
Save the page.
You can paste the widgets any number of times. Copying different widgets overwrites the clipboard content. Every user in the system has their own separate clipboard.
To remove a widget from the page:
You can also remove all widgets in a zone:
In both cases, you need to Save the page to confirm the deletion.
If the page contains the Widget actions web part, you can reset all widget zones on the page to their default content. The position of the widget actions depends on the design of individual pages. Possible locations are:
You can work with editor widgets through the on-site editing interface:
You can insert inline widgets directly when editing thetext sections of pages:
Both types of text editing are also available in on-site editing mode.
To add an inline widget into text:
Click Insert/Edit widget on the editor toolbar above the text area.
Select a widget from the catalog (you can only choose widgets that are allowed for inline use).
Click OK.
Set the properties of the widget (some widgets skip the initial property configuration dialog).
Click OK.
Save the text field's content.
The system uses placeholder images to represent widgets in editing mode.
On the live site and in preview mode, the page displays the full output of the widget along with the remaining text content.
You can use three different ways to open the properties dialog for existing inline widgets:
Double-click the widget placeholder image in the text
Right-click the placeholder image and select Properties
Select the placeholder image in the text and click Insert/Edit widget on the editor toolbar