---
title: Adding page content through widgets
related:
  - https://docs.kentico.com/k10/managing-website-content/working-with-pages/editing-pages/using-the-editor/inserting-widgets-using-the-editor.md
  - https://docs.kentico.com/k10/developing-websites/preparing-widgets-for-users/setting-up-widget-zones-on-pages.md
  - https://docs.kentico.com/k10/developing-websites/preparing-widgets-for-users.md
  - https://docs.kentico.com/k10/managing-website-content/configuring-the-environment-for-content-editors/configuring-workflows.md
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

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:

- Add [forms](https://docs.kentico.com/k10/managing-website-content/forms.md)
- Display dynamic lists of the website's content
- Change the layout of a page's content

Kentico contains a set of widgets by default. The developers of your website can also prepare additional widgets with any required functionality.

## Managing content in editor widget zones

You can add widgets on pages where the website's developers have prepared _editor widget zones_. The developers determine the following for each page:

- The number of widget zones on the page
- The position and size of individual zones
- The default widget content in the zones

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.

![Working with widget zones](https://docs.kentico.com/docsassets/k10/adding-page-content-through-widgets/working_with_widget_zones.png "Working with widget zones")

> **Note:** **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.

> **Info:** **Editor widgets and workflow**
>
> The content of editor widget zones is included within the scope of [workflow](https://docs.kentico.com/k10/managing-website-content/working-with-pages/using-workflows.md):
>
> - Editing of widgets is restricted by the rules of the defined workflow steps
> - Content changes do not appear on the live site until the page is published (after going through the workflow approval process)
> - The system tracks saved editor widget changes as part of [page versioning](https://docs.kentico.com/k10/managing-website-content/configuring-the-environment-for-content-editors/configuring-and-using-page-versioning.md)
>
> **Note**: Workflow does NOT apply to [Content personalization](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/content-personalization.md) or [Multivariate testing](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/optimization-testing/multivariate-testing.md) 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.

### Adding widgets

To add a widget to a zone:

1. Open the zone's menu ().
2. Click **Add new widget**.
3. Select a widget from the catalog (you can only choose widgets that are [allowed](https://docs.kentico.com/k10/developing-websites/preparing-widgets-for-users/configuring-permissions-for-widgets.md) for editor zones).
4. Click **Select**.
   - The widget configuration dialog opens (some widgets skip the initial property configuration dialog).
5. Set the properties of the widget.
6. Click **OK**.

   - The widget appears within the content of the page (inside the selected zone), but is NOT permanently saved yet.
7. Click **Save** to confirm the change to the page's widget content.

### Configuring widgets

To edit the properties of existing widgets on the page:

1. Hover over the widget.
2. Expand the widget's menu ().
3. Click **Configure**.

   ![Configuring widget properties](https://docs.kentico.com/docsassets/k10/adding-page-content-through-widgets/configuring_widgets.png "Configuring widget properties")
4. Set the widget's properties. To learn more about specific widget properties, hover over the field captions and read the tooltips.
5. Click **OK**.
6. **Save** the page.

> **Info:** For security reasons, the system does NOT resolve [macro expressions](https://docs.kentico.com/k10/macro-expressions.md) placed into the values of widget properties in the configuration dialog.

### Moving widgets

To move a widget between zones on the page or to a different position in the same zone:

1. Hover over the widget.
2. Move the mouse over the **Drag widget** () icon.
3. Drag the widget to the desired location.
4. **Save** the page.

### Copying widgets

Copying allows you to duplicate editor widgets and paste them into any editor zone, including _**other pages**_ on the same website.

You can copy:

- **Individual widgets** - hover over the widget, expand the widget's menu (), click **Copy**
- **All widgets in a zone** - open the zone menu (), click **Copy all**

The system saves the widgets and their configuration into an internal "clipboard". To paste the copied widgets:

1. Navigate to the target editor widget zone:
2. Place the copied widgets:

   - **at the end of the zone** - open the zone's menu (), click **Paste**
   - **directly below a specific widget** - hover over the widget, expand the widget's menu (), click **Paste**
3. **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.

### Deleting widgets

To remove a widget from the page:

1. Hover over the widget.
2. Expand the widget's menu ().
3. Click **Remove**.

You can also remove all widgets in a zone:

1. Open the zone menu ().
2. Click **Remove all widgets**.

In both cases, you need to **Save** the page to confirm the deletion.

> **Note:** When you remove widgets or whole widget zones, any content (such as text entered via a widget) no longer appears on the page, but remains preserved in the system. Such content may still impact your website, for example in search results.
>
> If you want to permanently delete all content of widgets (or whole widget zones) from the system, you first need to edit the widgets and re-save them as empty widgets without any content.

### Returning to the page's default widget content

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:

- Directly within the page content (only visible on the Page tab)
- In the header of the Page tab

![Resetting widget content to original state](https://docs.kentico.com/docsassets/k10/adding-page-content-through-widgets/resetting_widgets.png "Resetting widget content to original state")

### Managing editor widgets directly on the site

You can work with editor widgets through the [on-site editing](https://docs.kentico.com/k10/managing-website-content/configuring-the-environment-for-content-editors/enabling-on-site-editing.md) interface:

1. Log in on the live website.
2. Click  **Edit page** in the top left corner of the page.
3. Navigate to the page where you want to edit widgets.
4. Make the required changes to the page's widgets. The widget editing interface works the same way as on the **Page** tab of the Pages application.
5. Click **Save** on the on-site editing toolbar.

![Managing widgets on the live site](https://docs.kentico.com/docsassets/k10/adding-page-content-through-widgets/managing_widgets_on_live_site.png "Managing widgets on the live site")

## Adding inline widgets into text

You can insert inline widgets directly when [editing thetext sections of pages](https://docs.kentico.com/k10/managing-website-content/working-with-pages/editing-pages.md):

- Editable text regions on the **Page** tab
- Text area page fields on the **Form** tab

> **Info:** Both types of text editing are also available in [on-site editing](https://docs.kentico.com/k10/managing-website-content/configuring-the-environment-for-content-editors/enabling-on-site-editing.md) mode.

To add an inline widget into text:

1. Click **Insert/Edit widget** on the editor toolbar above the text area.

   ![Inserting a widget using the editor](https://docs.kentico.com/docsassets/k10/adding-page-content-through-widgets/inserting_widget_into_text.png "Inserting a widget using the editor")
2. Select a widget from the catalog (you can only choose widgets that are [allowed](https://docs.kentico.com/k10/developing-websites/preparing-widgets-for-users/configuring-permissions-for-widgets.md) for inline use).
3. Click **OK**.
4. Set the properties of the widget (some widgets skip the initial property configuration dialog).
5. Click **OK**.
6. **Save** the text field's content.

> **Info:** The system uses placeholder images to represent widgets in editing mode.
>
> On the live site and in [preview mode](https://docs.kentico.com/k10/managing-website-content/working-with-pages.md#available-view-modes), the page displays the full output of the widget along with the remaining text content.

### Configuring inline widgets

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

   ![Inserting a widget using the editor](https://docs.kentico.com/docsassets/k10/adding-page-content-through-widgets/inserting_widget_into_text.png "Inserting a widget using the editor")