Skip to main content

Block Tags and List/Choice

Block tags automatically show or hide content based on the item selected in a List or Choice field.

⚠️ Important

We recommend reading the tutorial What are Block tags? first, to properly understand their role and how to use them.

The examples shown here use fictional IDs. When applying this in practice, remember to replace them with the ones from your own form.

💡 Tip

To improve the readability of your template, feel free to highlight the block tags. This will help you spot them more quickly if you need to edit the document later. The highlighting stays invisible in the final export.

1. Display content based on the selected item

To automatically display text, a table, an image, or the content of a form field based on the item chosen in a List/Choice field:

  • Add _block: right after the first two hashes (##) of the field tag.

  • Add the -code suffix before the closing two hashes.

The syntax is as follows:

List field

Choice field

##_block:list-code##
Displayed content
##_block:list-code##

##_block:choice-code##
Displayed content
##_block:choice-code##

1.1 Display the logo of the selected client

In this example, we'll see how to display the logo corresponding to the selected client.

The List/Choice field is named Client and contains the following items:

  • B:Batimentek

  • D:Durand

The tag is ##client##. Here's an example layout:

Results:

  • If you select Batimentek, only the Batimentek logo will be displayed.

  • If you select Durand, only the Durand logo will be displayed.

  • If you don't select any item, no logo will be displayed.

2. Conditioning display with the IN operator

The IN operator lets you display content when:

  • Item1 OR Item2 is selected.

  • Item1 + Item2 are selected together.

The syntax is as follows:

Operator

Syntax

-in:

##_block:list-in:code1,code2##
Displayed content
##_block:list-in:code1,code2##

-in:

##_block:list-in:code1##
##_block:list-in:code2##
Displayed content
##_block:list-in:code2##
##_block:list-in:code1##

In the following examples, the List/Choice field is named Service and contains the following items:

  • INS:Installation

  • RE:Replacement

  • REP:Repair

The tag is ##service##.

2.1 Display content if INS or RE is selected

To display the Service tariffs table if Installation OR Replacement is selected:

Results:

Selected item

Table displayed

Installation

Replacement

Repair

Installation & Replacement

Installation & Repair

Replacement & Repair

None

2.2. Display content if INS + RE are selected

To display the Service tariffs table only if Installation + Replacement are selected together:

Results:

Selected item

Table displayed

Installation

Replacement

Repair

Installation + Replacement

Installation + Repair

Replacement + Repair

Installation + Replacement + Repair

None

3. Conditioning display with the NIN operator

The NIN operator lets you display content except in certain cases:

  • Except if only one item is selected.

  • Except if Item1 OR Item2 is selected.

In the following examples, the List/Choice field is named Service and contains the following items:

  • INS:Installation

  • RE:Replacement

  • REP:Repair

The tag is ##service##.

Operator

Syntax

-nin:

##_block:list-nin:code1##
Displayed content
##_block:list-nin:code1##

-nin:

##_block:list-nin:code1,code2##
Displayed content
##_block:list-nin:code1,code2##

3.1 Display content unless only one item is selected

To display the Service tariffs table unless Installation alone is selected:

Results:

Selected item

Table displayed

Installation

Replacement

Repair

Installation + Replacement

Installation + Repair

Replacement + Repair

None

3.2 Display a table unless INS or RE is selected

To display the Service tariffs table unless Installation OR Replacement is selected:

Results:

Selected item

Table displayed

Installation

Replacement

Repair

Installation + Replacement

Installation + Repair

Replacement + Repair

None

ℹ️ Good to know

Item1 OR Item2 means that if Item1 is selected together with an item other than Item2, the condition is no longer true — so the content is displayed.

4. Conditioning display with the LIKE operator

The LIKE operator lets you display content if the selected item contains a specific (alphanumeric) character string.

The syntax is as follows:

Operator

Syntax

-like:

##_block:list-like:code1##
Displayed content
##_block:list-like:code1##

In this example, the List/Choice field is named Client codes and contains the following items:

  • PART123:Individual1

  • PART234:Individual2

  • ENT567:Business1

  • ENT89:Business2

The tag is ##client_codes##.

To display the Service tariffs table if the selected item contains the string "PART":

Results:

Selected item

Table displayed

PART123

PART234

ENT567

ENT891

Did this answer your question?