Skip to main content

Best practices for block tags

Here are some essential rules to follow to prevent issues with block tags in your custom exports.

1. General rules

  1. They always start with ##_block:

  1. They're built using the tag of the field that controls whether the relevant part of the document is shown or hidden. For example: ##_block:tag##

  2. They cannot contain accents, spaces, or uppercase letters.

  3. They always work in pairs: one block tag to open, one to close.

  4. Each block tag must be alone on its line.

  5. The two block tags surround the part of the document to show/hide, as follows: ##_block:tag## Table, Text, Photo .... ##_block:tag##

  6. You must not place a page break or section break on the same line as a block tag.

  7. Block tags must not be placed in the document's header or footer.

  8. You can combine multiple block tags, except those containing the "in" and "nin" operators.

  9. When combining block tags, the first one opened must also be the last one closed, as shown in the example below.

2. Block tags are incompatible with:

  • Microsoft Excel.

  • Carriage returns.

3. Block tags and tables

  • The two block tags must both be either inside or outside a table — never one inside and the other outside.

  • In the Table Properties, if you select "Around" text wrapping, you also need to enable the "Move with text" option, accessible via the Position... button. Similarly, it's not recommended to enable the "Allow overlap" option found in the same place.

Did this answer your question?