Placeholder usage

Visforms placeholder usage

All areas in which Visforms placeholders can be used.

Note: Some of these features are part of the Visforms Subscription and are not included in the free Visforms version.

There are 2 types of areas in which Visforms placeholders can be used:

  • Formattable texts.
    For formattable free texts, the placeholders can be inserted using the editor button Visforms placeholders.
  • Text-like options.
    For text-like options, you must enter the placeholders manually.

Note: Fields of the type Submit button, Image submit button, Reset button and Field separator do not recognize placeholders.

Note: If the value of the placeholder to be inserted is empty, the entire placeholder is simply removed from the text.

Formattable texts

The placeholders can be inserted into all formattable texts using the Editor button Visforms placeholder.
The placeholders can also be inserted manually.

Formattable free texts

Direct use even without saved data

These placeholders also work if the data is not saved.

The placeholders are replaced during the current after-submit process.
The form object that knows the submitted data is used in the after-submit process.

The following texts can be provided with Visforms placeholders:

  • Form configuration
    • Result tab
      • Success text
    • Email options tab
      • Administrator email text
      • User email text
  • PDF template configuration (Visforms Subscription)
    • Document tab
      • Document
    • Header tab
      • Header
    • Footer tab
      • Footer

Delayed use only with saved form data

These placeholders only work if the data is saved.
If the data is not saved, values for certain placeholders may be empty.

Visforms placeholders can be entered in the following texts.

Data editing in the frontend (Visforms Subscription):

  • Form configuration
    • Edit email options tab
      • Administrator email text
      • User email text

PDF printing in the frontend and PDF printing in the PDF template configuration of the administration (Visforms Subscription):

  • PDF template configuration
    • Document tab
      • Document
    • Header tab
      • Header
    • Footer tab
      • Footer

Text-like options

Note: The placeholders for text-like options must be inserted manually.

Note: If an unknown placeholder name is misspelled, the entire placeholder is simply removed from the text.

These are special texts, often with technical meanings. Examples include link texts, file names, email addresses or URL parameters.

Placeholders with special formatting often make no sense here.
An example is the parameter ASIMAGE (Visforms Subscription) for the placeholder in the field type File Upload.

Note: For all field types, only their simple placeholder names should be used, without any parameters that are pointless in this sense.


Email configuration options

Form configuration options

Placeholders can be used in the following options:

  • General tab
    Maximum of one transfer = Yes » Action instead of the form = Show link to edit data.
    • Link text
  • Result tab
    • Forwarding URL
  • Email options tab
    • Administrator email (identical to user email)
      • Subject
      • Sender email, recipient email, mail CC, mail BCC.
        Only placeholders from email fields are accepted.
      • Sender name.
        Only placeholders from text fields and hidden fields are accepted.
    • User email (identical to administrator email)
      • Subject
      • Sender email, reply to email, mail CC, mail BCC.
        Only placeholders from email fields are accepted.
      • Sender name.
        Only placeholders from text fields and hidden fields are accepted.
  • Edit Email Options tab (Visforms Subscription)
    • Administrator Email (identical to User Edit Email)
      • Subject
      • Sender Email, Recipient Email, Mail CC, Mail BCC.
        Only placeholders from email fields are accepted.
      • Sender Name.
        Only placeholders from text fields and hidden fields are accepted.
    • User Email (identical to Administrator Edit Email)
      • Subject
      • Sender Email, Reply to Email, Mail CC, Mail BCC.
        Only placeholders from email fields are accepted.
      • Sender Name.
        Only placeholders from text fields and hidden fields are accepted.
  • Advanced tab
    • CSV export
      • Name of the CSV file
  • Email attachments tab (Visforms Subscription)
    The Mail Attachments plugin must be activated.
    • CSV export
      • Name of the CSV file
  • Edit email attachments tab (Visforms Subscription)
    The Mail Attachments plugin must be activated.
    • CSV export
      • Name of the CSV file

PDF configuration options

Placeholders can be used in the following options (Visforms Subscription):

  • General tab
    • Name of the PDF file

Field configuration options

Placeholders can be used in the following options:

  • Data usage in the frontend tab
    • Field type URL
      If ‘URL as link’ is activated.
      • Text before the link
      • Custom link text
      • Text after the link
    • Field type File upload
      If Show link in frontend is enabled and Custom text is selected.
      • Custom text