The Datepicker provides a way for a user to choose a specific date.


  1. Create your Form using the Forms for Confluence macro
  2. Add the Forms - Datepicker Field macro to the form
    Datepicker macro, Edit screen.
  3. Set a name for the Datepicker
  4. (Optional) Set a label for the Datepicker, this will appear next to the Datepicker
  5. (Optional) Set a description for the Datepicker
  6. Select an output format. The output format will define how the date is presented in the output mail and should be set to the most appropriate for your team,
    Selecting a Date Format in the Edit screen for the Datepicker macro.
    Available options are:
    • dd/MM/yyyy eg: 05/01/2017
    • MM/dd/yyyy eg: 05/01/2017
    • yyyy/MM/dd eg: 2017/05/01
    • dd-MM-yyyy eg: 05-01-2017
    • MM-dd-yyyy eg: 01-05-2017
    • yyyy-MM-dd eg: 2017-01-05 - this is the most appropriate format for use with a ScriptRunner Endpoint
    • dd.MM.yyyy eg: 05.01.2017
    • MM.dd.yyyy eg: 05.01.2017
    • yyyy.MM.dd eg: 2017.05.01
  7. (Optional) Exclude Date Format. Defines if the date format will be displayed next to the date in responses.
    Datepicker macro form without the Exclude Date Format selected.
    Datepicker macro form with the Exclude Date Format selected.
  8. (Optional) Set the required parameter. Ensures 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. (Optional) Set Date Validation. Force the user to select future or past dates
  14. Save the macroA graphical placeholder of the macro will be added to the page.
    Datepicker macro placeholder.
  15. Preview or Save the page to see the final checkboxes
    Rendered Datepicker macro with the example configuration.