AI agents: the content index is at /llms.txt. Every page is also available as Markdown — send the request header Accept: text/markdown, or append .md to the page URL.
We use necessary cookies (opens in a new tab) to run our website and improve your experience while browsing. Additional cookies are only used with your consent. You may revoke your consent on the Cookies Policy (opens in a new tab) page or in your browser at any time.
Is this really the version you are looking for? Kentico Xperience 9 Documentation is no longer updated. Use the switcher in the header to choose your product version.
Recommending pages to personas | Kentico Xperience 9 Documentation
Recommending pages to personas
Kentico EMS required
Features described on this page require the Kentico EMS license.
You can recommend different pages on a page based on current visitor's persona. For example, you can display different articles to a visitor assigned to a persona named Patient and different articles to a visitor assigned to a persona named Foreigner.
Consider adding different personas to the same page. The page's content may be appropriate for more than one persona.
Navigate to the page that you want to assign personas to.
Switch to the Properties -> Personas tab.
Click on Add personas. A Select personas dialog opens.
Select the personas that you want to assign to the page.
Click on OK. The system assigns the personas to the page.
You have defined which pages are appropriate for which personas. You can now use a widget or a web part to display personalized content on the page.
To assign personas to multiple pages
Consider adding different personas to the same pages. The pages' content may be appropriate for more than one persona.
In the Pages application, switch to Listing.
Filter the pages that you want to see.
Select the pages that you want to assign personas to.
In the first drop-down list under the listed pages, choose whether you want to perform the action on Selected pages or All pages.
In the second drop-down list, choose Tag pages with personas. A Select personas dialog opens.
Select the personas that you want to assign to the pages.
Confirm by clicking on OK. The system assigns the personas to the pages.
You have defined which pages are appropriate for which personas. You can now use a widget or a web part to display personalized content on the page.
Placing a widget to recommend content to personas
Navigate to the page on which you want to recommend content.
On the page, open a widget zone's menu (). A Select widget dialog appears.
In the Online Marketing folder, select Persona-based Recommendations.
Click on OK. A Widget properties dialog opens.
Specify the widget properties. Hover over the properties to see their description.
By default, transformations for displaying news articles and e-commerce products are available. Developers can create new transformations in the Personas.Transformation page type.
Confirm by clicking on OK.
Now, when a visitor assigned to a persona visits the page, the widget displays the pages for the particular persona.
Placing a web part to recommend content to personas
Navigate to the page on which you want to recommend content.
Place the Persona-based Recommendations web part on the page. A web part properties dialog appears.
Select the Path to the pages that the web part displays.
(Optional) Select the Page types that the web part displays. Not selecting any Page types makes the web part display pages from any Page types.
(Optional) Specify the Select top N pages field.
Select a transformation for displaying the content. There are two example transformations available in Personas - Transformations.
By default, transformations for displaying news articles and e-commerce products are available. You can create new transformations in the Personas.Transformation page type.
(Optional) To increase performance, specify the Columns that are loaded for the displayed pages. Use only the columns that you load in your transformations.
(Optional) Configure how the web part chooses the pages it displays.
Specify the rest of the web part properties.
Confirm by clicking on OK.
Now, when a visitor assigned to a persona visits the page, the web part displays the pages for the particular persona.
Configure how the Persona-based recommendations widget and web part display content
By default, if there isn't enough tagged pages to display for the persona viewing the page, the web part displays other pages of the specified Page types. You can change the behavior so that only the tagged pages for the specific persona are displayed.
To change which pages the web part displays:
In the web part properties, remove the macro in the ORDER BY expression.
The expression sorts pages so that tagged pages are displayed first. Untagged pages are displayed only if there isn't enough tagged pages to display.
Into the WHERE condition field, enter the following macro: {% PersonaDocumentWhereCondition %}
The where condition ensures that only tagged pages are displayed. Note that the WHERE condition also loads pages faster than the default OrderBy macro.
Confirm by OK.
You have changed the behaviour of the widget/web part so that it only displays pages tagged by the visitor's persona.