Recruitment Channel — User Guide
Module: Recruitment
Audience: Recruiters, HR administrators, marketing staff managing job applications
Version: 1.0.0
Last updated: 2026-07-22
Overview
A recruitment channel is a public web form that lets job applicants submit their details online. Each submission creates a candidate profile in Synergy with a status you define (for example, Application or Potential). You can customize the form fields, success message, language, and who gets notified when someone applies.
Channels connect to recruitment campaigns so applicants are automatically linked to the correct opening.
Prerequisites
- Permission: Recruitment → View to open the channel list. Create to add channels. Edit to change forms. Delete to remove channels.
- Campaigns (recommended): Link a channel to a campaign so applicants are assigned to the right requisition.
- Job positions / settings: Configure under Recruitment → Setting as needed for downstream workflows.
Step-by-step: View recruitment channels
- Go to Recruitment → Recruitment channel.
- Review the table: form name, responsible person, form type, and default candidate status.
- Click a form name to open the preview panel on the right.
- Use the double-chevron button to expand or collapse the split view.
Expected result: A list of web forms with a preview showing the public URL, embed code, CV count, and configuration summary.
Step-by-step: Create a recruitment channel
- On the Recruitment channel page, click New.
- On the Form information tab, complete:
- Form name
- Form type (Form)
- Form language (validation messages)
- Submit button text and Success submit message
- Status — pipeline stage assigned to new applicants (e.g. Application)
- Notify assigned user — responsible staff member
- Notification settings — optionally notify staff when a new candidate applies (specific staff, roles, or the responsible person)
- Open the Form builder tab and drag fields onto the form (name, email, phone, experience, etc.).
- Click Submit.
Expected result: The channel appears in the list. Open the preview to copy the public form URL or iframe embed code.
Step-by-step: Link a channel to a campaign
- Go to Recruitment → Campaign and create or edit a campaign.
- In the campaign modal, select a Recruitment channel form.
- Save the campaign.
- Open the campaign preview — the public application URL is shown (includes campaign ID and form key).
Expected result: Applicants who use that URL are linked to the campaign automatically.
Alternatively, use the generic channel URL from the channel preview (…/forms/wtl/0/{form_key}) and ensure the form or process assigns the correct campaign.
Step-by-step: Edit a recruitment channel
- In the channel list, click Edit on the row (or open
add_edit_recruitment_channel/{id}). - Update form information or form builder fields.
- Click Submit.
Expected result: Changes are saved. Note: Saving may generate a new form key — update any published links or embed codes and re-check the campaign assignment.
Step-by-step: Delete a recruitment channel
- In the channel list, click Delete on the row.
- Confirm deletion.
Expected result: The channel is removed. Campaigns that referenced this form will no longer show a valid apply URL until you assign a different channel.
Step-by-step: Share the public form
- Open the channel preview (click the form name).
- Under Integrate form website, copy the Form URL or the Embed form iframe code.
- Share the link on your careers page, job board, or email campaigns.
Expected result: Applicants complete the form; a new candidate profile appears in Recruitment → Candidate profile with the status you configured.
Field reference (form information tab)
| Field | Required | Description |
|---|---|---|
| Form name | Yes | Internal and display name |
| Form type | Yes | Currently Form only |
| Form language | Yes | Locale for public form validation |
| Submit button text | Yes | Label on the public submit button |
| Success submit message | Yes | Shown after successful submission |
| Status | Yes | Candidate pipeline stage for new applicants |
| Notify assigned user | Yes | Default responsible staff |
| Notify when new candidates | No | Sends in-app notification on submit |
| Notification target | No | Specific staff, roles, or responsible user |
Common issues
| Symptom | Likely cause | What to do |
|---|---|---|
| Cannot see Recruitment channel menu | Missing View permission | Ask admin for Recruitment → View |
| Form URL returns 404 | Wrong or outdated form key | Copy fresh URL from channel preview after edits |
| Applicants not linked to campaign | Channel URL uses 0 campaign segment |
Link channel on campaign modal or use campaign-specific URL |
| No notification on apply | Notifications disabled or wrong target | Enable Notify when new candidates and set staff/roles |
| CV count looks wrong in preview | Count logic tied to channel/campaign IDs | Verify candidates in Candidate profile list |
| Cannot submit edits | Missing Create permission on edit page | Request Create or ask admin to save |
| Embed form blank | Form builder has no fields | Add fields on Form builder tab before publishing |
Related features
- Recruitment → Campaign — assign channel form; shows apply URL on preview
- Recruitment → Candidate profile — destination for form submissions
- Recruitment → Setting — job positions and evaluation criteria for downstream hiring
- Recruitment portal — job listings can surface the linked apply form