Getting Started

FreshForms brings powerful, customizable forms directly into your Confluence pages — no external tools required. Whether you’re building a time-off request system, equipment checkout tracker, or feedback form, FreshForms makes it fast and flexible.

🔧 What Is FreshForms?#

FreshForms is a macro-based form builder that lives inside Confluence. You use macros to add fields, logic, and result tables — all styled natively and easy for teams to use.

📦 What You’ll Need#

Before you begin, make sure you have:

✅ Confluence Data Center
✅ FreshForms plugin installed
✅ Permission to add/edit pages in your Confluence space

🛠️ Core Macros You’ll Use#

FreshForms is made of simple building blocks. Here’s what you’ll work with:

• FreshForms Container - Wraps your form and powers it
• FreshForms TextField - For short answers like names or emails
• FreshForms TextBox - For longer inputs like notes or comments
• FreshForms Dropdown / Radio / Checkbox - Let users pick options
• FreshForms Date Field - For dates like deadlines or birthdays
• FreshForms Status - For tagging things like Approved or In Progress
• FreshForms File Attachment - Upload files with submissions
• FreshForms Conditional Field - Show or hide questions based on answers
• FreshForms Results - Display all submitted form data in a clean table

🎬 How It Works (in 3 Steps)#

1. Add a FreshForms Container Macro
   Every form starts with this. It’s where you define settings like the form name.
2. Insert Field Macros Inside
   Add TextFields, Dropdowns, and others within the container to build your form.
3. Drop in a FreshForms Results Macro (optional)
   View form submissions right on the page, filter by fields, or export to Excel.

💡 Pro Tips#

• Use Status fields to track approval or task state
• Add Descriptions to guide users while filling out fields
• Combine with Page Properties or Include Page for advanced setups
• Each submission is saved per page – perfect for team/project-specific tracking