The form input field is a highly flexible field that can be used to take a variety of inputs, as well as providing validation of input.


  1. Create your Form using the Forms for Confluence macro
  2. Add the Forms -  Input Field macro to the form
    The configuration screen for an Input Field macro.
  3. Set a name for the field
  4. (Optional) Set a label for the field, this will appear next to the field
    An indication to the Name and Label fields in the configuration screen for Input Field macro.
  5. (Optional) Set a description for the field
    An indication to the Description fields in the configuration screen for Input Field macro.
  6. (Optional) Set a default value for the field. This includes velocity values with access to some velocity value fields.
  7. (Optional) Set the validation
  8. (Optional) Set the required parameter. Ensure that users must supply a value for this field.

  9. (Optional) Set Field width. Defines the horizontal width occupied by the field in the form.
  10. (Optional) Set Label width. Defines the horizontal width occupied by the label associated to the field.
  11. (Optional) Set CSS Class
  12. (Optional) Set CSS Style
  13. Save the macro to see a placeholder image of how the field will look on the saved page
    The placeholder for the Input Field macro.
  14. Save the page to see the final field on your form
    The rendered example of the Input Field macro, once configuration is saved.

Using Velocity Values with the Input Field

The input field provides access to velocity to capture logged in users information and adds this as the value for the field. We've limited the values you can obtain from velocity for security reasons, however you can obtain velocity values using the following calls in the Velocity Value field:

  • $
  • $user.fullName
  • $