Recruit Variables are pseudo-module fields that store static, reusable information in your Zoho Recruit account, and you can deploy them as merge fields across email templates, mail merge operations, and extensions to automate communication and data handling.[1]
Why this matters
When you're managing recruitment workflows at scale, you need consistent, centralized values that don't change between campaigns or candidate touchpoints. Recruit Variables let you define those values once—company name, standard email signatures, job category labels—and reference them everywhere without manual updates. This cuts repetition, reduces errors, and makes your extensions and email templates far easier to maintain.
Step-by-step
Step 1. Create a Recruit Variable in your account settings.
Navigate to your Zoho Recruit account settings and locate the Recruit Variables section. Define a unique name for the variable (for example, CompanyName or DefaultJobCategory) and assign it a set of static values that will remain consistent across your recruitment operations.[1]
Step 2. Reference the variable in email templates.
When composing email templates for candidate outreach or internal notifications, insert the Recruit Variable as a merge field. The exact syntax depends on your template editor, but the variable will pull its stored value at send time, ensuring every email carries the same approved text or data.[1]
Step 3. Use the variable in mail merge operations.
If you're performing bulk mail merges to candidates or contacts, select the Recruit Variable from the available merge field list. Zoho Recruit will substitute the variable's value into each merged document automatically.[1]
Step 4. Integrate the variable into extensions.
When building or configuring extensions for Zoho Recruit, you can pass Recruit Variables as parameters or reference them within your extension logic. This is particularly useful if your extension needs to filter records, populate forms, or customize behavior based on company-wide settings. Consult your extension's documentation for the specific parameter names and data types it expects.[^4,7]
Step 5. Test the variable output.
Before deploying variables to production workflows, send a test email or run a test merge to confirm the variable resolves to the correct value. This prevents miscommunication or data errors reaching candidates or team members.
Common pitfalls
If a Recruit Variable is referenced in an extension but the variable name is misspelled or does not exist, the extension may fail to initialize or display a blank value. Always verify the exact link name of the variable in your settings before embedding it in extension parameters or template code.
Recruit Variables are account-level settings; if you have multiple Zoho Recruit organizations, each organization maintains its own set of variables. Switching between organizations without updating variable references can cause extensions or templates to pull incorrect data.
What to check
- Confirm the Recruit Variable appears in your account settings and displays the correct static values.
- Send a test email or merge document and verify the variable substitutes the expected text or data.
- If using the variable in an extension, check that the extension parameter name matches the variable's link name exactly and that the data type is compatible with the extension's requirements.
---
*Beam Help — independent expert support for Zoho. This article is not official Zoho support.*