Status Field

The Status Field lets you track form progress using clearly labeled color-coded badges. Ideal for workflows like approvals, issue tracking, or project phases. Each status shows as a tag with a label you define, plus a color you select.


How to Add a FreshForms Status Field

  1. Edit the page where you want to add the form.
  2. Click the “Insert More Content” button (usually represented by a “+” icon).
  3. From the dropdown, select Other Macros.
  4. Then type FreshForms- scroll and select FreshForms Status.

This will insert a FreshForms Status Field within the Container Macro.

Screenshot 04-20-2025 10.34.42.png


Configuration Options

Field Name

Required. A unique, alphanumeric identifier — no spaces or special characters. This is used internally for sorting, filtering, and logic operations.

Example: approvalStatus, taskState, caseStatus

Label

The prompt shown above the status field. Should clearly describe what the status represents.

Example: Approval Status, Current Phase, Case Progress

Description

Optional text shown below the label. Use it to explain what each status option means or how it’s used.

Example: “Set the current status of this task. Use ‘Done’ only when fully complete.”

Required

Check this box to make this a mandatory selection. Users must pick a status before submitting the form.

Status Options + Color Badges

You add status labels one at a time. Each label appears as a badge with your selected color. You have full control over the text and color, so you can align the status with your process.

Note: The label you enter overrides the default text that appears on the badge — you can name it anything.

Available Colors

  • Green — Approved, Complete, Active
  • Red — Denied, Urgent, Error
  • Blue — Info, In Review, Planning
  • Purple — Custom, Assigned, Waiting
  • Yellow — Pending, Caution, Waiting
  • Grey — Inactive, On Hold, Neutral

Screenshot 04-20-2025 10.42.35.png

Screenshot 04-20-2025 10.34.56.png

Screenshot 04-20-2025 10.35.58.png