---
title: Enabling on-site editing
related:
  - https://docs.kentico.com/k12sp/managing-website-content/working-with-pages/working-with-pages-on-the-live-site.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).

Kentico provides a way to work with the content of websites through a convenient on-site editing interface. This allows editors to make changes to page content and manage pages directly while viewing the website from the live site perspective.

All actions that can be done via on-site editing are also available in the **Pages** application. It simply offers a different way to edit the website that may be quicker and easier in many cases (particularly for users who prefer a minimal interface). It is recommended to use the **Pages** application for creating the core structure of new sites or when performing complex changes. On‑site editing is most suitable for adding or adjusting the content of an existing website that is already running.

## To allow on-site editing for your website:

1. Open the **Settings** application.
2. Go to **Content -> Content management**.
3. Select **Enable On-site editing**.
4. (Optional) Check **Enable On-site editing button**.

   - Determines whether the system displays the _Edit page_ button in the corner of pages on the live site for users who are authorized as editors.
   - If disabled, users can access on-site editing mode through the _\~/cmsedit_ URL, or by following links provided by the **Edit page link** or **Admin actions** web parts.
5. Click **Save**.

Authorized editors can now open the website in on-site editing mode through the following URL:

_http:////**cmsedit**_

Just like the standard Kentico interface, on-site editing mode requires authentication and a logon screen opens if you are not signed in yet. Editors who are already logged in on the live site may switch to on-site editing mode by clicking the **Edit page** button displayed in the corner of the page. This opens the on-site editing interface for the page that is currently being viewed.

![Opening on-site editing mode through the Edit page button](https://docs.kentico.com/docsassets/k12sp/enabling-on-site-editing/accessing_onsite_editing.png "Opening on-site editing mode through the Edit page button")

On-site editing mode works just like the standard live site, with the addition of a toolbar above the page. The content and configuration of pages can be modified through the buttons on this toolbar, along with a special interface displayed when hovering over specific editable sections of the currently viewed page.

![Viewing a page in on-site editing mode](https://docs.kentico.com/docsassets/k12sp/enabling-on-site-editing/viewing_page_in_onsite_editing.png "Viewing a page in on-site editing mode")

To move between pages, use the site's standard navigation. All other functionality of the website is also available in on-site editing mode. However, there are several important differences from the regular live site that should be considered:

- On-side editing mode always displays pages in their current editing state, even if they are not [published](https://docs.kentico.com/k12sp/managing-website-content/working-with-pages/using-workflows.md) on the actual live site yet (like in the Preview and Edit view modes of the Pages application). This makes it possible to view and modify pages before they are presented to the website's regular visitors.
- All forms of page redirection are disabled. This allows editing of pages that would normally be forwarded to a different address on the live site. You can identify pages that are configured for redirection by the presence of a message box, which also provides a link to the target page.
- If a _Page not found_ error occurs while browsing in on-site editing mode, it is handled by a special system page that contains a link to the root of the website.

## Setting up user accounts for on-site editing

### Editor prerequisite

Like with the main administration interface, [users](https://docs.kentico.com/k12sp/managing-users.md) need to be designated as editors to access on-site editing mode.

1. Open the **Users** application.
2. Edit () the user.
3. On the **General** tab, set the **Privilege level** to _Editor_ (or higher).
4. Click **Save**.

The system now recognizes the given user as an editor.

### Permissions

There are several [permissions](https://docs.kentico.com/k12sp/managing-users/configuring-permissions.md) that affect on-site editing. You can configure these permissions for specific roles in the **Permissions** application.

| Module      | Permission                                                                                                                                                                                   | Description                                                                                                                                                                                           |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Content     | Read                                                                                                                                                                                         | Only users who belong to roles that have this permission are able to enter on-site editing mode.                                                                                                      |
| Modify      | Allows users to edit page fields and the content of editable regions.                                                                                                                        |                                                                                                                                                                                                       |
| Create      | Allows users to create new pages.                                                                                                                                                            |                                                                                                                                                                                                       |
| Delete      | Allows users to delete existing pages from the website.                                                                                                                                      |                                                                                                                                                                                                       |
| Browse tree | Users need this permission to perform page management actions, such as creating and deleting pages or viewing the page list. It is not required for basic work with editable region content. |                                                                                                                                                                                                       |
| Design      | Design website                                                                                                                                                                               | Users need this permission to configure the properties of web parts through the on-site editing interface. For users without this permission, the system only highlights editable regions and images. |

Additionally, all permissions configured for page types or individual pages also apply in on-site editing mode.

### UI personalization

You can also customize the visibility of individual elements on the on-site editing toolbar and in the related dialogs for particular [roles](https://docs.kentico.com/k12sp/managing-users/role-management.md) via [UI personalization](https://docs.kentico.com/k12sp/managing-users/ui-personalization.md).

1. Open the **UI personalization** application.
2. Select the appropriate **Site** and **Role**.
3. Choose the _CMS On-site editing_ **Module**.
4. Configure the checkboxes as required. The available options match individual buttons on the main on-site editing toolbar.

Members of the selected role can now see only the specified UI elements.

> **Note:** **Note**: All of the UI personalization options set for the **Content** module also apply (for example various page property tabs or the web part properties dialog).
