--- title: Personalizing web parts and web part zones related: - https://docs.kentico.com/k11/on-line-marketing-features/managing-your-on-line-marketing-features/content-personalization.md - https://docs.kentico.com/k11/on-line-marketing-features/managing-your-on-line-marketing-features/content-personalization/personalizing-editor-widgets.md - https://docs.kentico.com/k11/on-line-marketing-features/managing-your-on-line-marketing-features/content-personalization/setting-display-conditions-for-personalization-variants.md - https://docs.kentico.com/k11/developing-websites/developing-websites-using-the-portal-engine.md - https://docs.kentico.com/k11/developing-websites/developing-websites-using-the-portal-engine/using-and-configuring-web-parts.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). > **Info:** **Kentico EMS required** > > Features described on this page require the **Kentico EMS** license. Once content personalization is [enabled](https://docs.kentico.com/k11/on-line-marketing-features/configuring-and-customizing-your-on-line-marketing-features/configuring-content-personalization.md), you can create variants of page components through the **Pages** application. Variants of page components can be displayed to visitors based on various conditions. For example, you can use different component variants to display different content to different [Personas](https://docs.kentico.com/k11/on-line-marketing-features/managing-your-on-line-marketing-features/personas.md). There are three possible types of components that you can personalize: - [Web parts](#personalizing-web-parts) – can be personalized by users with the **[Design website](https://docs.kentico.com/k11/managing-users/configuring-permissions/configuring-design-permissions.md)** permission for the **Design** module on a page's **Design** tab. - [Web part zones](#personalizing-web-part-zones) – can be personalized by users with the **[Design website](https://docs.kentico.com/k11/managing-users/configuring-permissions/configuring-design-permissions.md)** permission for the **Design** module on a page's **Design** tab. - [Editor widgets](https://docs.kentico.com/k11/on-line-marketing-features/managing-your-on-line-marketing-features/content-personalization/personalizing-editor-widgets.md) – can be personalized by content editors on pages with editor widget zones. See [Personalizing editor widgets](https://docs.kentico.com/k11/on-line-marketing-features/managing-your-on-line-marketing-features/content-personalization/personalizing-editor-widgets.md#adding-personalization-variants-for-editor-widgets) for more information. > **Info:** **Multivariate testing and Content personalization** > > It is _not_ possible to create personalization variants of web parts, zones or widgets that already have [Multivariate testing](https://docs.kentico.com/k11/on-line-marketing-features/managing-your-on-line-marketing-features/optimization-testing/multivariate-testing.md) variants. > **Tip:** **Overviews of personalization variants** > > To access a list of all content personalization variants defined on a given page: > > 1. Select the page in the content tree of the **Pages** application. > 2. Open the page's **Properties -> Variants** tab. > > The list includes the variants of all three component types. ## Personalizing web parts Content personalization of web parts allows you to create different versions of web parts with different property settings. To add personalization variants for web parts: 1. In the **Pages** **application**, edit the page containing the web part on the **Design** tab. 2. Click the web part's  icon, hover over **Personalization variants** and click **Add web part variant**. ![Adding a new web part variant](https://docs.kentico.com/docsassets/k11/personalizing-web-parts-and-web-part-zones/adding_webpart_variant.png "Adding a new web part variant") 3. Fill in the [display condition](https://docs.kentico.com/k11/on-line-marketing-features/managing-your-on-line-marketing-features/content-personalization/setting-display-conditions-for-personalization-variants.md) and other [settings](#reference---personalization-variant-properties) of the personalization variant. (Personas) Specify an _IsInPersona_condition, such as **{% _Contact.IsInPersona(GlobalObjects.Personas.SeanG)_ %}**, where _SeanG_is the name of the persona. ![](https://docs.kentico.com/docsassets/k11/personalizing-web-parts-and-web-part-zones/variant_properties.png) 4. Click **Save & Close**. - The standard web part configuration dialog opens – the variant is simply another instance of the original web part. - By default, the variant has the same values in its properties as are set for the original, but you can change them as required. 5. Click **Save & Close** once you have configured the variant's web part properties as required. 6. (Optional) [Preview the different web part variants](#previewing-personalization-variants) using the personalization slider in the header of the web part. - The configuration of each web part variant has an additional **Variant properties** tab, where you can modify the [settings](#reference---personalization-variant-properties) of the personalization variant. > **Note:** > > - When configuring a variant of a web part, you can specify a unique [Web part layout](https://docs.kentico.com/k11/custom-development/developing-web-parts/using-custom-web-part-layouts.md) for each variant on the **Layout** tab. > - Removing a web part also deletes all of its variants. > - When you **Copy** a web part with variants, the system only transfers the original web part. > **Info:** The system stores the variants of personalized web parts on the given page's [page template](https://docs.kentico.com/k11/developing-websites/developing-websites-using-the-portal-engine/creating-portal-engine-page-templates.md), so the variants are present on all pages that use the same template. ## Personalizing web part zones If you need to define personalized content that uses completely different web parts for each variant, create variants of entire web part zones. For each zone variant, you can: - Add or remove child web parts - Configure the properties of the web part zone - Configure the properties of the child web parts Each zone variant may contain any type or amount of web parts, regardless of what is placed inside other variants or the original zone. When you create a new zone variant, the system automatically copies the content of the original zone. You do not have to rebuild the zone from scratch if you only need to make small modifications. > **Note:** **Note**: You cannot personalize zones that already contain personalized web parts. The same also applies in the opposite direction: You cannot add variants for individual web parts inside personalized zones. Additionally, personalization is only supported for standard web part zones and cannot be done for [widget zones](https://docs.kentico.com/k11/developing-websites/preparing-widgets-for-users/setting-up-widget-zones-on-pages.md). To add personalization variants for web part zones: 1. In the **Pages** **application**, edit the page containing the web part zone on the **Design** tab. 2. Click the  icon, hover over **Personalization variants** and click **Add zone variant**. 3. Fill in the [display condition](https://docs.kentico.com/k11/on-line-marketing-features/managing-your-on-line-marketing-features/content-personalization/setting-display-conditions-for-personalization-variants.md) and other settings of the personalization variant. - (Personas) Specify an _IsInPersona_condition, such as **{% _Contact.IsInPersona(GlobalObjects.Personas.SeanG)_ %}**, where _SeanG_is the name of the persona. 4. Click **Save & Close**. - The zone configuration dialog opens for the variant. - By default, the variant has the same values in its properties as are set for the original zone. 5. Click **Save & Close** once you have configured the zone variant's properties as required. 6. (Optional) [Preview the different zone variants](#previewing-personalization-variants) using the personalization slider in the header of the zone. - The configuration of each zone variant has an additional **Variant properties** tab, where you can modify the settings of the personalization variant. > **Info:** The system stores the variants of personalized zones on the given page's [page template](https://docs.kentico.com/k11/developing-websites/developing-websites-using-the-portal-engine/creating-portal-engine-page-templates.md), so the variants are present on all pages that use the same template. ## Previewing personalization variants You can use the sliders of personalized page components to switch between individual variants (including the original). The page displays the content of the currently selected variants in the **Pages** application on the page's **Design** tab, **Page** tab and in the **Preview** mode. The system only **resolves the display conditions** of personalization variants **on the actual live site**. This allows you to check how the page looks with different active variants, without having to fulfill the required conditions. Simply set the sliders to the appropriate variants. > **Tip:** When viewing the content of variants while cycling through sliders on the **Design** tab, make sure that you have the **Web part content** checkbox selected in the page header. ## Editing the content of personalized pages On pages with personalized web parts that provide editable regions ( **Editable text** or **Editable image** ), you can enter unique content for each variant. 1. In the **Pages** **application**, view the personalized page on the **Page** tab. 2. Hover over the personalized section of the page. - A menu icon appears. 3. Select the variant that you wish to edit or view. The system reloads the page with the content of the chosen variant. You can edit and save the variant's content as required. ![Switching between the variants of an editable text region](https://docs.kentico.com/docsassets/k11/personalizing-web-parts-and-web-part-zones/editing_personalized_pages.png "Switching between the variants of an editable text region") ## Reference - Personalization variant properties The following properties are available when creating or configuring personalization variants: | Property | Description | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Display name | The name displayed in lists of content personalization variants in the administration interface. | | Description | To make the variant easier to use and maintain, you can add an explanation about the scenario for which the variant is intended, describe the differences from the original component, etc. | | Enabled | Indicates if the variant is considered as a possible content option.
When evaluating the variant conditions of a personalized component, the system skips disabled variants (even if the requirements set by the condition are fulfilled). | | Display condition | Enter the [condition](https://docs.kentico.com/k11/on-line-marketing-features/managing-your-on-line-marketing-features/content-personalization/setting-display-conditions-for-personalization-variants.md) that must be fulfilled for the page to display the variant. By utilizing [macro expressions](https://docs.kentico.com/k11/macro-expressions.md), you can write any condition. In order to work correctly, the result of the expression must be a logical (boolean) value.
**Example**:
_(CurrentDateTime.Hour >= 9) && (CurrentDateTime.Hour <= 17)_
Ensures that the variant is only displayed if the current time is between 9 AM and 5 PM. |