We’ve migrated our documentation to a new site, which means some URLs have changed.
Subscriptions

Consent Fields - FAQ

Q: Can I use special characters in the consent field text?

A: You can't use a reserved HTML character (e.g: &, >,<) in the field text, as it would cause issues for the browser distinguishing the text from HTML tags, symbols, etc.

Entering an HTML character will result in the error message below while saving:

Can't save consent - Display prompt shouldn't contain HTML tags except tag <a> and hyperlink text shouldn't be empty

To use an HTML character you must substitute the character for the character’s entity name.

For example, to use the & character, you would need to replace the literal character with its entity name &amp;.

A list of these entities can be found here.

Q: How to edit the look and feel of consent fields?

A: The terms and conditions checkbox and text are part of the Consent Components system template. To change how they are displayed, you can head from your Piano dashboard to ManageTemplates. Select the tab System to display system templates.

Then look for the template titled Consent Components and open it to edit.

For example, in order to open links in your Terms & Conditions in a new tab, you would be able to use the property target="_blank".

You may need some HTML knowledge to make the desired changes to this template so we advise asking someone with that knowledge to help.

You can create a new page with the consent text and add only a link to it next to the checkbox. You can also add a bold title line above the checkbox.

Q: Do the consent fields also apply to Apple Pay checkout?

A: Yes. When using Apple Pay as a payment option, customers authorize the payment externally, and upon returning to the checkout modal, they need to click on the "Complete Purchase" button. This step triggers the validation process, which ensures that the required consents are checked before allowing the customer to proceed with the purchase. Therefore, customers cannot complete the purchase via Apple Pay without agreeing to the mandatory terms and conditions.

Last updated: