The Forms feature lets management company administrators build custom portal forms for homeowners using a drag-and-drop form builder in CMP. Each form is linked to an action item type (such as ARC Request or General Request) and renders for homeowners on the Vantaca Home portal when they submit a request. You can create multiple forms within the same category to support different scenarios, and you can edit, preview, duplicate, or delete forms as needed.
Important: Forms requires the Form Management permission. To assign it, go to Settings > Roles, select the role, go to Settings, and click Edit next to Form Management.
Contents
- Permissions
- Before You Begin
- What Homeowners See
- Access Form Management
- Default Starter Forms
- Create a New Form
- Use the Form Builder
- Customize Forms for a Specific Association
- How the ARC Model Affects ARC Forms
- Form States
- Manage Existing Forms
- Delete a Form
- How Form Submissions Appear in CMP
- Frequently Asked Questions
- Related Articles
Permissions
Navigate to Settings > Roles and find the role you want to assign the permission to. Go to Settings and click Edit next to Form Management, then select the permissions the role needs:
- View: Shows the Form Management screen, including the Global Forms and Association Forms tabs and form previews.
- Edit: Allows users to create, edit, and duplicate forms, add and remove overrides, link association copies, and hide or show forms for an association. They can also undo these actions while the Undo message is showing.
- Delete: Allows users to delete forms, and to undo a deletion while the Undo message is showing.
Buttons a user does not have permission to use do not appear. For the full list of permissions, see the "Role Securities" article.
Before You Begin
Before creating forms, ensure the following:
- The Form Management permission is assigned to your role (see Permissions).
- The action item types you plan to associate with forms are already configured in Settings > Action Types/Steps.
What Homeowners See
Once at least one form is published for an association, the homeowner's New Request entry point changes from a direct list of request-type buttons to a category and form picker. For a description of that picker from the homeowner's point of view, see the "Vantaca Home: Architectural Requests" and "Vantaca Home: Submitting General Requests" articles, which also cover Service Requests.
Access Form Management
Navigate to Settings > Form Management. The Form Management page has two tabs:
- Global Forms: Forms that apply to every association in your management company by default. A homeowner sees a Global form for their request type unless the association has an override of that form or has hidden it.
- Association Forms: Everything one specific association's homeowners can see. Select an association at the top of the tab. It lists each global form with whether it is shown or hidden for that association, the association's overrides of global forms, and any forms that exist only for that association.
Each tab lists its forms with the form name and action item type. The Global Forms tab also shows status, overrides, hidden forms, and last modified date. The Association Forms tab shows where each form comes from (Source) and whether homeowners see it (Homeowners).
For how overrides, hidden forms, and extra forms work, see the "Vantaca Home: Global Forms, Overrides, and Hidden Forms" article.
Default Starter Forms
Your management company starts with three default forms on the Global Forms tab that match the standard request types homeowners already submit:
- ARC Request: The standard architectural review request form.
- General Request: The standard general request form.
- Service Request (Work Order): The standard service request form.
These forms render the same fields homeowners are used to seeing. You can edit them to add custom fields or create additional forms within each category.
Important: This is not a migration. Your existing request workflows continue to work the same way for homeowners. Forms simply makes those previously hardcoded forms editable and lets you add more.
Create a New Form
- From the Form Management page, choose the Global Forms tab for a form that applies to every association, or the Association Forms tab and select an association for a form that only that association needs, then click New Form.
- Select a pre-built template (for example, ARC Request or Service Request) to start with its recommended fields already in place, or choose Blank Form to start from scratch.
The form builder opens with your selection loaded. - Click Form Settings and enter a name for the form (for example, ARC Request - Fence).
- Select an Action Item Type to associate with this form.
When you select an action item type, the form builder automatically loads the required fields for that action item type. - Drag additional field types from the field palette onto the form canvas to customize the form.
- Configure each field's properties in the right-side settings panel.
- Click Save.
Note: A form you create on the Association Forms tab is an extra form. Homeowners see it in addition to the global forms. It does not replace a global form. To give an association its own version of a global form, use Add Override instead. See "Vantaca Home: Global Forms, Overrides, and Hidden Forms".
Use the Form Builder
The form builder has these main areas:
- Form canvas: The visual area where you compose and arrange fields. Drag fields up or down to reorder them.
- Field palette (Add Fields): Drag field types onto the canvas to add them to your form.
- Field Settings: Configures properties for the field you have selected.
- Form Settings: Includes the Action Item Type option to associate with your form, plus form name and description fields.
Field Types
The palette includes 16 field types organized into three categories.
Entry fields (homeowner fillable):
- Single Line Text: A short text input.
- Paragraph Text: A multi-line text input.
- Dropdown: A list of options where the homeowner selects one.
- Checkboxes: A list of options where the homeowner can select multiple.
- Radio Button: A list of options where the homeowner selects one.
- Address: A structured address input.
- Phone: A phone number input.
- Date: A date picker.
- Number: A numeric input.
- File Upload: An attachment field for documents, plans, or images. Homeowners can upload directly from a computer or mobile device using this field. It replaces the QR code scan that the ARC request form previously used for uploading photos from a phone.
Dynamic fields (auto-populated from system data):
- Property: Pulls the homeowner's properties from the database. Required for ARC requests.
- Area of Work: Pulls configured area-of-work options. Required for ARC requests.
- Supporting Documents: Surfaces the documents from the association's document library that the homeowner can reference when filling out the form. For ARC forms, these are the files in the association's Documents > Forms > ARC folder. New ARC forms include this field by default. If an existing ARC form is missing it, add it from the field palette.
Layout fields (non-input):
- Title: A heading to break up form sections.
- Section: A grouping container for related fields.
- Description: Instructional text shown to the homeowner.
Required Fields
When you select an action item type, the form builder automatically loads the required fields for that action item type. These fields cannot be removed because they are required for the form submission to flow correctly into CMP.
- ARC Request required fields: Subject, Details, Property, Area of Work.
- General Request required fields: Subject, Details.
- Service Request required fields: Subject, Details.
You can reorder required fields and add additional fields around them. Any custom fields you add are captured separately in the action item note when the form is submitted.
Configure Field Settings
Click any field on the canvas to open its settings in the right panel. Common settings include:
- Label: The display name for the field.
- Placeholder: Hint text shown inside an empty field.
- Help Text: Additional guidance shown below the field.
- Required: Toggle on to require the homeowner to complete this field before submitting.
For Dropdown, Checkboxes, and Radio Button fields, use the options manager in the settings panel to add, edit, remove, and reorder choices.
Form Settings and Action Item Type
Click Form Settings on the right to update the form name, description (internal notes), or action item type. The Action Item Type dropdown is limited to action item types in the Homeowner Request, ARC Requests, and Work Orders categories. For an ARC form on the Association Forms tab, the dropdown is limited to the association's current ARC Model type. For a global ARC form, it offers the Model Association's ARC Model type. See How the ARC Model Affects ARC Forms.
Important: If you edit a form that is already associated with an active action item type, a warning message displays. Existing submissions are not affected by your changes, but any homeowner submissions made after you save will use the updated form.
Customize Forms for a Specific Association
By default, every form you create on the Global Forms tab is available to all associations in your management company. When one association needs something different, you can replace a global form with that association's own version, hide a global form for that association, or add a form that only that association has.
- An override is an association's own version of a global form. Homeowners at that association see the override instead of the global form. Other associations keep the global form. Use Add Override on the Global Forms tab to give one or more associations their own copy.
- A hidden global form does not show for that association. Use Hide Form on the Association Forms tab. Other associations are not affected, and Show Form brings it back.
- An extra form exists only for one association and appears alongside the global forms. Create it with New Form on the Association Forms tab.
- Remove Override removes the association's override form and puts the association back on the global form. It does not keep a standalone copy of the form.
Tip: To stop one association from using a global form, click Hide Form for that association on the Association Forms tab. Other associations keep the form.
Overrides, hidden forms, and linking currently apply to ARC forms. For steps, see "Vantaca Home: Global Forms, Overrides, and Hidden Forms" and "Vantaca Home: Link Association Form Copies".
How the ARC Model Affects ARC Forms
Each association has an ARC Model setting, configured in Association Settings under ARC, that determines the action item type and stepping rules used for that association's architectural review requests. ARC-category forms follow this setting automatically:
- When you create or edit an ARC form on the Association Forms tab, the Action Item Type dropdown is limited to the association's current ARC Model type. You cannot assign an ARC form to a different ARC type than the one the association uses.
- Global ARC forms show for every association, including associations that use their own ARC Model. When a homeowner submits a global ARC form or an override, the request creates an action item of that association's own ARC Model type.
- ARC forms do not show for an association when its ARC Model is (Choose an ARC Model) or its ARC Request page is turned off in Association > Portal Pages. A banner on the Association Forms tab explains which applies. Other form types are not tied to an ARC Model.
Important: Form Management shows the ARC Model that applies to each ARC form. On the Association Forms tab, this is the association's current ARC Model. On the Global Forms tab, global ARC forms show Association's ARC Model as the action item type, because each association's requests use its own ARC Model.
If an association's ARC Model setting changes, its ARC forms keep showing to homeowners and follow the new ARC Model. There's nothing to reassign or resolve, and no form disappears. To see which ARC Model each association uses and which ARC forms its homeowners see, click View ARC forms by association on the Global Forms tab. See "Vantaca Home: Global Forms, Overrides, and Hidden Forms".
Form States
Forms have three states:
- Draft: The form is saved but is not yet associated with an action item type. Draft forms do not render for homeowners. Use this state when you are still building or refining a form.
- Live: The form is associated with an action item type. Live forms render for homeowners on the Vantaca Home portal when they submit a request of that type. Note: Live reliably means the form is visible to homeowners. See How the ARC Model Affects ARC Forms.
- Blocked: The form is associated with an action item type that is set to block creation, so it can no longer accept new submissions. Blocked forms do not render for homeowners, and homeowners cannot open or submit them, even through a saved or bookmarked link.
To move a form from Draft to Live, edit the form and select an action item type in the Form Settings panel.
Note: A form becomes Blocked when its associated action item type is later set to block creation, for example, when you retire a request type. In the Form Management table, the Status column shows Blocked with a tooltip explaining that the form is hidden from homeowners because its action item type is set to block creation. To make the form available again, remove the block on the action item type, or delete the form if you no longer need it.
Note: An override follows its global form's state. If the global form moves to Draft or becomes Blocked, its overrides stop showing to homeowners too. The Homeowners column on the Association Forms tab shows the reason, for example Not shown: global form is Draft.
Manage Existing Forms
The options in each row depend on the tab and on where the form comes from:
- Edit: Opens the form builder with the selected form loaded for editing.
- Preview: Opens a read-only view of the form as homeowners will see it.
- Duplicate: Creates a copy of the form with the same fields and settings. Available on the Global Forms tab, in the More actions menu. Useful for creating variations within the same category (for example, separate ARC forms for fences, paint, and structural changes).
- Delete: Permanently removes the form. See Delete a Form below.
- Add Override: Creates an association's own copy of a global form. Available on global ARC forms and on global rows on the Association Forms tab.
- Hide Form and Show Form: Hide a global form for the selected association, or show it again.
- Remove Override: Removes an association's override so the association uses the global form again.
- Make Override of…: Turns a form that exists only for one association into an override of a global form.
- Link association copies: In the More actions menu of a global form. Turns many associations' look-alike copies into overrides at once.
For details, see "Vantaca Home: Global Forms, Overrides, and Hidden Forms" and "Vantaca Home: Link Association Form Copies". After most changes, a confirmation message with an Undo button appears for about 7 seconds.
Delete a Form
Deleting a form permanently removes it from Form Management. After the confirmation message closes, this cannot be undone, and homeowners can no longer submit new requests using that form. If you delete a form by mistake, click Undo in the confirmation message right away.
A form must be in Draft status before it can be deleted. If the form is currently associated with an action item type, remove that association first:
- From the Form Management page, click Edit on the form to open it in the form builder.
- Open Form Settings and click Clear Action Item Type.
This removes the action item type link and reverts the form to Draft status. - Click Save, then return to the Form Management page.
- Choose the Global Forms or Association Forms tab, depending on where the form lives.
- Find the form you want to remove, then click Delete in that form's row.
- Confirm the deletion when prompted.
Note: If you only want to stop a form from applying to one association without deleting it, click Hide Form for a global form, or Remove Override for an override. Remove Override removes the override form. See Customize Forms for a Specific Association.
Note: You cannot delete a global form that still has overrides. Remove its overrides first.
How Form Submissions Appear in CMP
When a homeowner submits a form, CMP creates an action item of the associated type. The submitted data is split into the following locations:
- Required fields (Subject, Details, Property, Area of Work): Map directly to the matching database columns and display in their standard locations on the action item.
- Custom fields (anything you added beyond the canonical set): Capture in the action item note so staff can review the additional context the homeowner provided.
- File uploads: Display in the Attachments section on the action item.
Existing submissions that were made before you edited the form are not affected. Each submission retains the form structure that was in place at the time it was submitted.
Frequently Asked Questions
Q: Do I need to create a new ARC form when I change an association's ARC Model?
A: No. Global ARC forms show for every association, and requests create an action item of the association's own ARC Model type. ARC forms no longer disappear when the ARC Model changes. For more detail, see How the ARC Model Affects ARC Forms.
Q: Homeowners at one association see two versions of the same ARC form. How do I fix it?
A: The association may have its own copy of a global form. On the Association Forms tab, click Make Override of… on the association's form to make it replace the global form, or click Hide Form on the global form. To fix many associations at once, see "Vantaca Home: Link Association Form Copies".
Q: A global ARC form shows as Hidden for an association, but we never hid it. Why?
A: When overrides were introduced, Vantaca hid the global ARC forms for some associations that use their own ARC Model and already had their own ARC form, so homeowners saw the same forms as before. Click Show Form on the row to show a global form again.
Q: A homeowner cannot see an ARC form. What should I check?
A: On the Association Forms tab, select the association and read the Homeowners column and any banner at the top of the tab. See "Vantaca Home: Global Forms, Overrides, and Hidden Forms".
Related Articles
- "Vantaca Home: Global Forms, Overrides, and Hidden Forms"
- "Vantaca Home: Link Association Form Copies"
- "Vantaca Home: Architectural Requests"
- "Vantaca Home: Submitting General Requests"
- "Association Settings"
Comments