Custom Forms
Complete guide to creating and using custom forms in CitoHR.
Overview
Custom Forms allow administrators to create tailored forms for collecting information from employees. Forms can be used for surveys, data collection, requests, and various other purposes. Employees can fill out assigned forms and submit responses.
Prerequisites
- You must be logged in to your CitoHR account
- Forms must be created and assigned by administrators
- Admin role required to create custom forms
Accessing Forms
- Log in to your CitoHR account
- Click on Forms or Custom Forms in the main navigation menu
- You'll see a list of forms assigned to you or available to you
Viewing Available Forms
See all forms you can fill out:
- On the Forms page, you'll see a list showing:
- Form name and description
- Status (Not Started, In Progress, Completed)
- Due date (if applicable)
- Assigned by (who created or assigned the form)
- Submission status
- Click on a form name to open and fill it out
- Use filters to view:
- All forms
- Pending (not yet started)
- In Progress
- Completed
- Overdue
Filling Out a Form
Complete a form that's been assigned to you:
- Click on a form from your forms list
- The form will open showing all fields
- Read the form instructions at the top (if provided)
- Fill in each field according to its type:
- Text fields - Type your response
- Text areas - Enter longer text responses
- Dropdowns - Select from available options
- Radio buttons - Select one option
- Checkboxes - Select multiple options
- Date fields - Click to open calendar picker, select date
- Number fields - Enter numeric values
- File upload - Click to upload files
- Required fields are marked with an asterisk (*) or red border
- Review all your entries
- Click "Save Draft" to save progress without submitting, or
- Click "Submit" or "Submit Form" to complete
- Once submitted, you may not be able to edit your responses
Tip
You can save your progress on longer forms and return to complete them later. Look for the
"Save Draft" button to save without submitting.
Important
Once you submit a form, you may not be able to edit your responses. Make sure all information
is correct before submitting. Review all fields carefully.
Viewing Submitted Forms
Review forms you've already submitted:
- On the Forms page, filter by "Completed"
- Click on a completed form
- You'll see a read-only view of your submitted responses
- Review the submission date and any notes from administrators
Creating a Custom Form (Admin)
Build a new custom form:
- Navigate to Admin > Forms or Custom Forms
- Click "Create Form" or "New Form"
- Fill in form basic information:
- Form Name - Enter a descriptive name
- Description - Add instructions or context for the form
- Category - Select a category (optional)
- Add form fields:
- Click "Add Field" or "Add Question"
- Select field type:
- Text - Single line text input
- Textarea - Multi-line text input
- Dropdown - Select from options
- Radio - Single choice from options
- Checkbox - Multiple selections
- Date - Date picker
- Number - Numeric input
- File Upload - File attachment
- Configure each field:
- Field label
- Help text or instructions
- Required/optional setting
- Default value (if applicable)
- Options (for dropdowns, radio, checkboxes)
- Validation rules
- Use drag handles to reorder fields
- Configure form settings:
- Allow Draft Saving - Enable/disable draft saving
- Allow Editing After Submit - Let users edit after submission
- Due Date - Set deadline (optional)
- Status - Set to Draft or Active
- Click "Save Form" to save as draft, or
- Click "Publish Form" to make it active
Assigning Forms to Employees (Admin)
Assign forms to specific employees or groups:
- Navigate to Admin > Forms
- Find the form you want to assign
- Click the "Assign" button
- In the assignment dialog:
- Select employees:
- Individual employees (use checkboxes)
- Entire departments
- By role
- All employees
- Set due date (optional)
- Add assignment notes (optional)
- Select employees:
- Click "Assign Form"
- Selected employees will receive notifications about the assigned form
Viewing Form Responses (Admin)
Review submissions for a form:
- Navigate to Admin > Forms
- Click on a form to view its details
- Navigate to the "Responses" or "Submissions" tab
- You'll see a list of all form submissions showing:
- Employee name
- Submission date
- Status (Submitted, Draft, Overdue)
- Response summary
- Click on a submission to view full responses
- Export responses to CSV or Excel if needed
Screenshot Placeholder
Form responses list showing all submissions
/screenshots/docs/features/forms/viewing-form-responses/screenshot.png
Editing Forms (Admin)
Modify existing forms:
- Navigate to Admin > Forms
- Find the form you want to edit
- Click the "Edit" button
- Make your changes:
- Add, remove, or modify fields
- Update form settings
- Change field order
- Click "Save Changes"
- If the form has already been assigned, employees may need to resubmit if significant changes were made
Warning
Be careful when editing forms that have already been assigned. Significant changes may invalidate
existing submissions or require employees to resubmit.
Related Features
- Onboarding - Forms can be used in onboarding processes
- User Management - Assign forms to users from their profiles
- Reports - Generate reports from form responses
