Last update: Edit

1 Introduction

Text is a group of widgets that consists of Text, Paragraph, Headings (H1-H6), and the Page Title. They are used to display textual information to the end-user. For example, you can display a text paragraph:

2 Text, Paragraph, and Headings General Properties

You can use Text, Paragraph, or Heading widgets to display a text to the end-user. In Properties > General, you can type the text that will be displayed, define if it contains attribute values, and set the render mode.

2.1 Content

In Content, you define the text that will be shown. You can also add attributes, and the attribute value will be displayed to the user. For example, when the user logs in to the account, a greeting message can be shown, where Name and NumberOfMessages are attribute values:

2.1.1 Configuring Content Without Adding Attributes

To configure Content without adding attributes, you can do one of the following:

  • Double-click the widget on the page and start typing the text you want to show to the end-user; press Enter to save changes
  • Open Properties of the widget, delete the default text in the General section > Content, and type the message you want to show to the end-user

2.1.2 Configuring Content and Adding Attributes

To configure Content and add attributes to it, do the following:

  1. Place the widget (Text, Paragraph, or Heading) inside a data container (a list view or a data view) and set an entity for the list view/data view. For more information, see Data View & List View. This is necessary to allow attributes of the selected entity to be inserted into the text.

  2. Open Properties of the Text, Paragraph, or Heading, delete the default text in the General section > Content and start typing the message you want to show to the end-user.

  3. To insert attribute values into your message, click Add attribute or press Ctrl + Space. The list of attributes which can be inserted will be shown.

  4. Scroll through the list of attributes (you can also use Up and Down arrows for that) and select the attribute you want to add to the Text.

  5. Type the rest of the text, and insert more attributes if required, to finish your message.

You have configured the Content of your widget. If you want to edit it, you can double click the widget in the page; the Edit Text pop-up dialog will be shown for widgets with attributes in their content.

2.2 Render Mode

The render mode defines the way a text will be shown to the end-user. Basically, Text, Paragraph, and Heading widgets are different render modes of the same widget. Possible values of the render mode are described in the table below.

Value Description
Text The text will be rendered inline with the previous/next widgets on a page
Paragraph The text will be rendered as a separate paragraph
H1-H6 The text will be rendered as a heading. H1 is the largest type of the heading, H6 is the smallest one.

3 Page Title General Properties

The page title widget sets the title of the current page and displays it. This title also appears as the page title in your browser tab. The title will be displayed in the H1 style of the Theme Customizer. For details, see Theme Customizer.

If you want to change the name of the page, do the following:

  1. Open Properties of the widget > the General section.
  2. Change a name in the Title field.

The page title is changed.

The Title that you see in the page properties and in widget is one and the same. This means, if you make changes to the title in page properties, this change will be displayed in the widget, and vice versa.

4 Conditional Visibility Section

Conditional visibility allows you to hide a widget from a page unless the certain conditions are met.

For information on the Conditional Visibility section and its properties, see Conditional Visibility Section.

5 Design Section

For information on the Design section and its properties, see Design Section.

6 Read More