--- title: "Form Element Best Practices" slug: "form-element-best-practices" description: "Learn more about the best practices that should be applied when adding elements to a form. " updated: 2026-03-19T21:10:23Z published: 2026-03-19T21:10:23Z canonical: "www.civicplus.help/form-element-best-practices" --- > ## Documentation Index > Fetch the complete documentation index at: https://www.civicplus.help/llms.txt > Use this file to discover all available pages before exploring further. # Form Element Best Practices The following best practices should be applied when adding [elements to a form](/process-automation/docs/form-element-types). ## Element Labels Element Labels should: - Provide a clear description for the end-user (such as First Name) - Use title case and appropriate punctuation - Not be longer than 35 characters > [!WARNING] > **Note**: > > If a longer explanation is needed for a field, use an Information element. ![Text element details for entering a pet name with character limits specified.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Text%20Element%20Label%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A31Z&se=2026-11-22T13%3A51%3A31Z&sr=b&sp=r&sig=3VoA2P7pzGgIVaU5Lqujz5FCfsGJDzX2Fg5QNualiNU%3D) --- ## Element Name - Element Name should provide code-friendly markup for the developer (such as First_Name) - If [submitting to the HCMS](/process-automation/docs/hcms-integration), Element Names: - Must be unique when converted to lowercase (Using "Element1" and "element1" as Names for separate elements allowed, but will fail if submitted to HCMS as it will see them both as "element1".) - Cannot contain special characters other than underscores and dashes - Cannot start or end in an underscore or dash - Cannot exceed 40 characters ![Input field for pet name with regular expression validation instructions displayed below.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Element%20Name%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A31Z&se=2026-11-22T13%3A51%3A31Z&sr=b&sp=r&sig=DnrL9CJHsBRigLvubXeK2fAMTvhNkaySzMhkCPvzQac%3D) --- ## Lists - Alphabetize all option lists![Options for selecting animals including Bird, Cat, Dog, Rabbit, and Other.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Alphabetized%20List%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A31Z&se=2026-11-22T13%3A51%3A31Z&sr=b&sp=r&sig=92vhm%2BH6avfVDGHMr5fTfpAeBJZ5N%2F8WWdjZdNIdzzs%3D) - Options such as “Other” or “None of the Above” should be used at the end of the list, as they indicate alternative choices from the set of options - When ‘Other’ is provided as an option, a text element for ‘Other’ should be [conditionally provided](/process-automation/docs/add-conditions-to-a-form)![Form fields for selecting pet type and describing other pets in a survey.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Describe%20Other%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A51%3A31Z&se=2026-11-22T13%3A51%3A31Z&sr=b&sp=r&sig=PPCIBOwUDHi4tXNK0Hxkh9Y2C%2FV5oZOjwZ1K3Rg%2BO5s%3D) --- ## Specific Element Settings - [Information Elements](/process-automation/docs/form-element-types#information): All external links within the form should open in a new window - [Checkbox and Radio Elements](/process-automation/docs/form-element-types#radio-buttons): Configure to ‘display as buttons’ for the best mobile experience - [Image Element](/process-automation/docs/form-element-types#image): The label configured for the image will be utilized as alternative (alt) text for accessibility. Utilize [this guide for guidance on writing effective alt-text descriptions](https://webaim.org/techniques/alttext/). --- ## Specific Content Settings - **Mailing Addresses:** Provide the following items as individual Text elements: - Address 1, Address 2, City, State, Zip Code