Update form

Update an existing form’s configuration, elements, and deployment settings. Requires site manager permissions.

Updatable Fields:

• name: Form title and identifier
• description: Purpose and instructions
• elements: Complete element configuration (add, modify, remove)
• siteIds: Site deployment changes
• publicAccess: Enable/disable public submission
• passwordProtected: Security settings
• metadata: Custom attributes and categorization

Element Modification Impact:

• Adding Elements: Retroactively available for all submissions
• Removing Elements: Existing data preserved but inaccessible
• Changing Types: May cause data compatibility issues
• Updating Validation: Affects future submissions only

Best Practices:

• Version control: Consider creating new forms for major changes
• Data integrity: Test changes against existing submissions
• User communication: Notify data collectors of significant changes
• Backup: Export form configuration before major updates

Deployment Changes:

• Adding sites: Form becomes available to new locations
• Removing sites: Existing data preserved, new submissions blocked
• Site-specific customization preserved during updates