---
title: Forms V2 — Field & Configuration Reference
description: "Reference for configuring Forms V2 fields: Data Key rules, Redash SmDropdown, company dropdowns, upload settings, and phone number validation."
---
[Skip to content](https://go.sitemetric.com/sitemetric-knowledge-base/forms-v2-field-and-configuration-reference#main-content)
English - United States
Show submenu for translations
- Home
- Products
- Pricing
- Blog
- Company
Open main navigation
Close main navigation
- Home
- Products
- Pricing
- Blog
- Company
- English - United States
Show submenu for translations
- Contact us
Contact us
How can we help you?
- There are no suggestions because the search field is empty.
1. [Sitemetric Knowledge Base](https://go.sitemetric.com/sitemetric-knowledge-base?hsLang=en-us)
2. [Forms](https://go.sitemetric.com/sitemetric-knowledge-base/forms?hsLang=en-us)
3. [Reference Guide](https://go.sitemetric.com/sitemetric-knowledge-base/forms?hsLang=en-us#reference-guide)
# Forms V2 — Field & Configuration Reference
## Field configuration reference for Data Key, dropdowns, uploads, and phone validation in Forms V2
---
### Data Key (important)
> **Data Key is only needed for dropdowns** (Dropdown + SmDropdown). When you use it, **Data Key must match Key**.
- **Other field types should not have a Data Key**
- If you accidentally type anything into Data Key, the label turns **blue**
- Blue means it is active and adds a Data Key property to the field
- This can cause Forms V2 to error
- To clear it, click the **reset (X)** on the right of the Data Key input
- It should return to white (not active)
---
### Validation error shows before entering anything
- Navigate to the `errorMessage` field
- `Main`
- `Additional Properties`
- `Render When`
- Set **Render When** to **False**
- If it is **True**, the error message will always show, even before the form tries to validate
---
### Upload field behavior (Auto Upload + Removable)
- Uncheck **Auto Upload**
- If **Auto Upload** stays enabled, the field will try to upload the file directly to the server (instead of attaching it to the submission).
- Check **Removable**
---
### Upload field display (List Type)
- Quality of life only (does not affect form submission)
- Change **List Type** to **Picture Text**
- The field will show the **file name**
- It will also show a **small thumbnail** preview of the uploaded file
---
### Dropdown backed by custom Redash query (SmDropdown)
> ⬇️ If you are populating options from a **custom Redash query URL**, use **SmDropdown** (under **Custom**), not the standard **Dropdown** field.
- Set the Redash endpoint in **\`Url\`**
- Redash dropdown queries return two fields:
- **Label**: what the submitter sees in the dropdown
- **Value**: what we receive on our end (stored in the form result)
- **Selection Type** controls whether the form stores **Label** or **Value**
- For the \*project dropdown\* query, Label and Value are the same so it does not matter
- If Label and Value differ, Selection Type matters
- If you only want the site id (and not the name) in results, the Redash query response needs to be adjusted
---
### Company dropdown list (site companies)
> Forms V2 can now pull **company lists** for dropdowns from the site companies endpoint.
- Endpoint: [\`https://us.sitemetric.com/api/v4/sites/{{siteId}](https://us.sitemetric.com/api/v4/sites/%7B%7BsiteId%7D)}/siteCompanies\`
- Set:
- **Value key** = `company.name`
- **Label key** = `company.name`
---
### Phone numbers (Forms V2)
> Forms V2 does not have a dedicated **Phone Number** field like Forms V1. Use a **Number input** and add a Regex rule to enforce format.
- Short-term fix: add a validation rule
- Go to **Rules** → add **Regex** validation
- Regex: `^\\d{10}$`
- `^` = start of input
- `\\d{10}` = exactly 10 digits (0–9)
- `$` = end of input
- This means the entry must be **10 digits only**, with no spaces, dashes, or parentheses
- Custom message: `Phone number must contain 10 digits only (0–9)`
- [Reports](https://go.sitemetric.com/sitemetric-knowledge-base/reports?hsLang=en-us)
- [Integrations](https://go.sitemetric.com/sitemetric-knowledge-base/integrations?hsLang=en-us#main-content)
- [How-To Guide](https://go.sitemetric.com/sitemetric-knowledge-base/integrations?hsLang=en-us#how-to-guide)
- [SOP](https://go.sitemetric.com/sitemetric-knowledge-base/integrations?hsLang=en-us#sop)
- [Internal - Reporting & Data](https://go.sitemetric.com/sitemetric-knowledge-base/internal-reporting-data?hsLang=en-us)
- [Support Request Types](https://go.sitemetric.com/sitemetric-knowledge-base/support-request-types?hsLang=en-us#main-content)
- [General Inquiry](https://go.sitemetric.com/sitemetric-knowledge-base/support-request-types?hsLang=en-us#general-inquiry)
- [Device & Hardware](https://go.sitemetric.com/sitemetric-knowledge-base/support-request-types?hsLang=en-us#device-hardware)
- [Out of Scope](https://go.sitemetric.com/sitemetric-knowledge-base/support-request-types?hsLang=en-us#out-of-scope)
- [Installations & Onboarding](https://go.sitemetric.com/sitemetric-knowledge-base/support-request-types?hsLang=en-us#installations-onboarding)
- [Platform & Application](https://go.sitemetric.com/sitemetric-knowledge-base/support-request-types?hsLang=en-us#platform-application)
- [Data & Reporting](https://go.sitemetric.com/sitemetric-knowledge-base/support-request-types?hsLang=en-us#data-reporting)
- [Account & Billing](https://go.sitemetric.com/sitemetric-knowledge-base/support-request-types?hsLang=en-us#account-billing)
- [Internal - Agent & Bot Guidance](https://go.sitemetric.com/sitemetric-knowledge-base/internal-agent-bot-guidance?hsLang=en-us)
- [Product & Platform](https://go.sitemetric.com/sitemetric-knowledge-base/product-platform?hsLang=en-us)
- [Notifications & Messaging](https://go.sitemetric.com/sitemetric-knowledge-base/notifications-messaging?hsLang=en-us#main-content)
- [SOP](https://go.sitemetric.com/sitemetric-knowledge-base/notifications-messaging?hsLang=en-us#sop)
- [How-To Guide](https://go.sitemetric.com/sitemetric-knowledge-base/notifications-messaging?hsLang=en-us#how-to-guide)
- [Troubleshooting Guide](https://go.sitemetric.com/sitemetric-knowledge-base/notifications-messaging?hsLang=en-us#troubleshooting-guide)
- [Core Support Operations](https://go.sitemetric.com/sitemetric-knowledge-base/core-support-operations?hsLang=en-us#main-content)
- [SOP](https://go.sitemetric.com/sitemetric-knowledge-base/core-support-operations?hsLang=en-us#sop)
- [Reference Guide](https://go.sitemetric.com/sitemetric-knowledge-base/core-support-operations?hsLang=en-us#reference-guide)
- [Troubleshooting Guide](https://go.sitemetric.com/sitemetric-knowledge-base/core-support-operations?hsLang=en-us#troubleshooting-guide)
- [Handbook](https://go.sitemetric.com/sitemetric-knowledge-base/core-support-operations?hsLang=en-us#handbook)
- [Directory/Catalog](https://go.sitemetric.com/sitemetric-knowledge-base/core-support-operations?hsLang=en-us#directory-catalog)
- [Reporting & Data](https://go.sitemetric.com/sitemetric-knowledge-base/reporting-data?hsLang=en-us#main-content)
- [Reference Guide](https://go.sitemetric.com/sitemetric-knowledge-base/reporting-data?hsLang=en-us#reference-guide)
- [Troubleshooting Guide](https://go.sitemetric.com/sitemetric-knowledge-base/reporting-data?hsLang=en-us#troubleshooting-guide)
- [Directory/Catalog](https://go.sitemetric.com/sitemetric-knowledge-base/reporting-data?hsLang=en-us#directory-catalog)
- [SOP](https://go.sitemetric.com/sitemetric-knowledge-base/reporting-data?hsLang=en-us#sop)
- [How-To Guide](https://go.sitemetric.com/sitemetric-knowledge-base/reporting-data?hsLang=en-us#how-to-guide)
- [Admin Portal How-Tos](https://go.sitemetric.com/sitemetric-knowledge-base/admin-portal-how-tos?hsLang=en-us#main-content)
- [How-To Guide](https://go.sitemetric.com/sitemetric-knowledge-base/admin-portal-how-tos?hsLang=en-us#how-to-guide)
- [Handbook](https://go.sitemetric.com/sitemetric-knowledge-base/admin-portal-how-tos?hsLang=en-us#handbook)
- [Directory/Catalog](https://go.sitemetric.com/sitemetric-knowledge-base/admin-portal-how-tos?hsLang=en-us#directory-catalog)
- [Forms](https://go.sitemetric.com/sitemetric-knowledge-base/forms?hsLang=en-us#main-content)
- [Troubleshooting Guide](https://go.sitemetric.com/sitemetric-knowledge-base/forms?hsLang=en-us#troubleshooting-guide)
- [Directory/Catalog](https://go.sitemetric.com/sitemetric-knowledge-base/forms?hsLang=en-us#directory-catalog)
- [Reference Guide](https://go.sitemetric.com/sitemetric-knowledge-base/forms?hsLang=en-us#reference-guide)
- [Devices & Hardware](https://go.sitemetric.com/sitemetric-knowledge-base/devices-hardware?hsLang=en-us#main-content)
- [SOP](https://go.sitemetric.com/sitemetric-knowledge-base/devices-hardware?hsLang=en-us#sop)
- [Reference Guide](https://go.sitemetric.com/sitemetric-knowledge-base/devices-hardware?hsLang=en-us#reference-guide)
- [How-To Guide](https://go.sitemetric.com/sitemetric-knowledge-base/devices-hardware?hsLang=en-us#how-to-guide)
- [Site & Campus Management](https://go.sitemetric.com/sitemetric-knowledge-base/site-campus-management?hsLang=en-us#main-content)
- [Reference Guide](https://go.sitemetric.com/sitemetric-knowledge-base/site-campus-management?hsLang=en-us#reference-guide)
- [SOP](https://go.sitemetric.com/sitemetric-knowledge-base/site-campus-management?hsLang=en-us#sop)
- [User Access & Accounts](https://go.sitemetric.com/sitemetric-knowledge-base/user-access-accounts?hsLang=en-us#main-content)
- [Reference Guide](https://go.sitemetric.com/sitemetric-knowledge-base/user-access-accounts?hsLang=en-us#reference-guide)
- [Troubleshooting Guide](https://go.sitemetric.com/sitemetric-knowledge-base/user-access-accounts?hsLang=en-us#troubleshooting-guide)
- [SOP](https://go.sitemetric.com/sitemetric-knowledge-base/user-access-accounts?hsLang=en-us#sop)
- [App Features & Product Documentation](https://go.sitemetric.com/sitemetric-knowledge-base/app-features-product-documentation?hsLang=en-us#main-content)
- [Reference Guide](https://go.sitemetric.com/sitemetric-knowledge-base/app-features-product-documentation?hsLang=en-us#reference-guide)
- Home
- Products
- Pricing
- Blog
- Company
[](https://go.sitemetric.com/?hsLang=en-us)
[mailto:email@email.com](mailto:email@email.com)
Copyright © 2026, www.sitemetric.com