Multiple labels behaviour with Match All

Beginning with Visibility 5.0.15, when using multiple labels within the Labels parameter with Match Using set to all, the Show-If and Hide-If macros will check if the labels within the parameter are all present on a given page's labels.

Take a look at the following table for more examples:

Match UsingShow-If/Hide-If Labels parameter valuePage LabelsShow-IfHide-IfNotes
alllabel-onelabel-oneMatches.
alllabel-onelabel-one, label-twoMatches since label-one is on the page's labels. The extra label label-two on the page does not affect the outcome.
alllabel-twolabel-one, label-twoMatches since label-two is on the page's labels. The extra label label-one on the page does not affect the outcome.
alllabel-one, label-twolabel-oneDoes not match since label-two is missing from the page's labels. Note, the labels in the parameter must all be on the page's labels.
alllabel-one, label-twolabel-one, label-twoMatches since both label-one and label-two are on the page's labels.

✅ - the contents of the macro will be shown/visible
❌ - the contents of the macro will be hidden/invisible

How will this affect my pages?

In Visibility 5.0.10 - 5.0.14, when using multiple labels within the Labels parameter with Match Using set to all, the Show-If and Hide-If macros will check if the labels on a given page are all present within the parameter. This may sound the same, but the semantic difference may affect your Show-If and Hide-If macros.

The table below compares the behavior for Visibility 5.0.10 - 5.0.14 versus Visibility 5.0.15:

Match UsingShow-If/Hide-If Labels parameter valuePage LabelsShow-If (5.0.14)Show-If (5.0.15)Notes
alllabel-onelabel-oneMatches.
alllabel-onelabel-one, label-twoMatches in 5.0.15 since all the labels in the macro exists on the page's label.
alllabel-twolabel-one, label-twoMatches in 5.0.15 since all the labels in the macro exists on the page's label.
alllabel-one, label-twolabel-oneDoes not match in 5.0.15 since label-two is missing from the page's labels. Note, the labels in the parameter must all be on the page's labels.
alllabel-one, label-twolabel-one, label-twoMatches since both label-one and label-two are on the page's labels.
alllabel-one, label-two, label-threelabel-one, label-twoDoes not match in 5.0.15 since label-three is missing from the page's labels. Note, the labels in the parameter must all be on the page's labels.

To specify labels to exclude with Match Using set to any, see the Label parameter matrix.