From LibreOffice Help
Jump to: navigation, search

Variable fields let you add dynamic content to your document. For example, you can use a variable to reset the page numbering.

Choose Insert - Field - More Fields - Variables tab

Warning.png User-defined fields are only available in the current document.


Lists the available field types. To add a field to your document, click a field type, click a field in the Select list, and then click Insert. The following fields are available:

Type Description
Set Variable Defines a variable and its value. You can change the value of a variable by clicking in front of the variable field, and then choosing Edit - Field.
Show Variable Inserts the current value of the variable that you click in the Selection list.
DDE field Inserts a DDE link into the document, that you can update as often as you want through the assigned name.
Insert Formula Inserts a fixed number, or the result of a formula.
Input field Inserts a new value for a variable or a User Field.

The value of a variable in an Input field is only valid from where the field is inserted and onwards. To change the value of the variable later in the document, insert another Input field of the same name, but with a different value. However, the value of a User Field is changed globally.

The variables are displayed in the Selection field. When you click the Insert button, the dialogInput Field appears, where you can enter the new value or additional text as a remark.

Number range Inserts automatic numbering for tables, graphics, or text frames.
Set page variable Inserts a reference point in the document, after which the page count restarts. Select "on" to enable the reference point, and "off" to disable it. You can also enter an offset to start the page count at a different number.
Show Page Variable Displays the number of pages from the "Set page variable" reference point to this field.
User Field Inserts a custom global variable. You can use the User Field to define a variable for a condition statement. When you change a User Field, all instances of the variable in the document are updated.
Note.png The following fields can only be inserted if the corresponding field type is selected in the Type list.


Click the format that you want to apply to the selected field, or click "Additional formats" to define a custom format.

For user-defined fields, click the format that you want to apply in the Format list, or click "Additional formats" to define a custom format.


Type the name of the user-defined field that you want to create. To set a target, click "Set Reference" in the Type list, type a name in this box, and then click Insert. To reference the new target, click the target name in the Selection list.


Enter the contents that you want to add to a user-defined field.

In the Format list, define if the value is inserted as text or a number.


Lists the available fields for the field type selected in the Type list. To insert a field, click the field, and then click Insert.

Tip.png To quickly insert a field from the list, hold down Ctrl and double-click the field.

In an HTML document, two additional fields are available for the "Set variable" field type: HTML_ON and HTML_OFF. The text that you type in the Value box is converted to an opening HTML tag (<Value>) or to a closing HTML (</Value>) tag when the file is saved as an HTML document, depending on the option that you select.

Tip.png If you double-click an entry while holding the Ctrl key or select the desired variable and press the spacebar, it is immediately inserted into your document.


This option is only available if the "Insert formula" field type is selected.


Type the text that you want to display in the field. If you are inserting a placeholder field, type the text that you want to display as a help tip when you rest the mouse pointer over the field.


Enter the offset value that you want to apply to a page number field, for example "+1".


Hides the field contents in the document. The field is inserted as a thin gray mark in the document. This option is only available for the "Set Variable" and "User Field" field types.

Chapter numbering

Sets the options for resetting chapter numbers.


Choose the heading or chapter level at which to restart numbering in the document.


Type the character that you want to use as a separator between the heading or chapter levels.


Adds the user-defined field to the Selection list.



Removes the user-defined field from the selection list. You can only remove fields that are not used in the current document. To remove a field that is used in the current document from the list, first delete all instances of the field in the document, and then remove it from the list.