Custom fields in Worksome allow you to customize information at the Hire, Job, Trusted Contact (TC), Staffing agencies and Payment Request levels (including individual expenses on payment requests), helping tailor data to your organization’s unique needs. This guide covers how to set up and manage custom fields, including where they appear and who has access to add or edit them.
What Are Custom Fields?
Custom fields allow companies to add specific information that enhances Talent findability, personalization, and functionality within Worksome. Custom fields can be added to:
Jobs: Used for both new and existing jobs.
Trusted Contacts: Used when inviting new TCs or adding to existing TCs.
Hires: Used for details that belong to one specific hire rather than the whole job (e.g. cost centre or purchase order).
Payment Requests: Used to capture metadata (e.g. cost code, project reference, client, rights holder) on payment requests via timesheet lines.
Expenses: Used to capture details such as a GL code or cost centre on each individual expense (not on the expense report as a whole). Set up in their own Expenses custom fields section, separate from timesheet custom fields. Workers (or the staffing agency, on agency-managed hires) fill them in when adding or editing an expense. Full guide: Expense Custom Fields on Payment Requests.]
Where Are Custom Fields Displayed?
Custom fields are visible in several locations, depending on whether they’re set:
For Jobs:
On the contract (accessible through the conversation)
On existing jobs
During the direct hire process
For Trusted Contacts:
When inviting a new TC
On the TC’s profile page
For Hires
On the hire page, in a Hire fields group shown separately from the Job fields group
On the worker's draft hire page, for fields marked Completed by worker
For Payment Requests:
On the timesheet, as timesheet lines (workers log hours against them)
In the payment request/timesheet review view for approvers/clients
For Expenses:
On the expense form, below the description and above the expense date
Next to each expense in expense lists and on the payment request
On the client's payment request approval modal, expense files modal, pay form and bill card
On the client invoice, under each expense line
During onboarding:
In the worker onboarding checklist, if the field has "Use for worker onboarding" turned on
In the staffing agency onboarding checklist, if the field has "Use for staffing agency onboarding" turned on
On client invoices:
On the invoice PDF, if the field has "Show this field on client invoices" turned on
Who Can Set Up Custom Fields?
Permissions to create and manage custom fields vary based on role:
Organization-Level Fields: Only organization owners/admins can add and manage fields visible to all associated accounts.
Account-Level Fields: Only account owners can add and manage fields specific to their account.
How to Set Up a Custom Field
To set up a custom field, go to Company Settings > Custom Fields and click Add Custom Field. A setup window will appear for you to complete the following details (the example shows adding custom fields to Job):
For expense custom fields: first make sure Enable expense reports is turned on in Hiring settings.
Name
Enter a clear name for the custom field (e.g., "Background Check")
Input type
Text: For open text entries (e.g., "Additional Project Details").
Dropdown: For a list of predefined values (e.g., "Background Check" with options like "Criminal Check," "None Needed," "ID + RTW").
Multi-select dropdown: Like a dropdown, but users can select more than one value.
File upload: Lets users attach documents to the field (e.g., a signed agreement or a certificate).
When adding a file, you can upload a new file or select an existing one from their document bank.
Date: For a single date (e.g. "Start of assignment"). Shown in your account's date format.
Boolean – Yes/No: For a simple yes/no answer (e.g. "Worked here before").
Expense custom fields support Dropdown only. It is selected automatically and the other input types are not shown.
Description
Use this section to provide context or guidelines for the custom field
Settings
Enable for Approval Workflows: Adds the custom field to custom rules in approval workflows (applicable for jobs). Not available for file upload fields.
Make Required: Makes the field mandatory on all jobs, TCs, timesheets, expenses. Required payment request fields must be filled in before a timesheet or payment request can be submitted. Required expense fields must be filled in before the expense can be saved.
API Only: Allows updates to this field via API only. Not available for file upload fields and expense fields, because they are always visible to workers.
Use for worker onboarding: Adds the field to the worker onboarding checklist. Requires worker onboarding to be enabled for your account. If the field is also required, workers must complete it before they can access conversations, hire offers or shared jobs. If this is off, the field stays internal and workers do not see it.
Use for staffing agency onboarding: Adds the field to the staffing agency onboarding checklist. Requires staffing agency onboarding to be enabled for your account. If the field is also required, the agency must complete it before it can access conversations, hire offers or shared jobs. If this is off, the field stays internal.
Completed by worker (hire fields only): The worker – or the staffing agency managing them – fills in this field while the hire is still a draft, before the offer is sent.
When you create a hire with such fields, you're asked to confirm that the draft will be shared with the worker. The worker gets an email and sees the draft on their dashboard, without the rate or contract. They can save answers one at a time and come back later.
You see the value read-only, marked Worker completed. If the field is also required, the offer can't be sent until it has a value.
For MSP hires, the worker is only asked once the MSP starts Onboard worker, not when the client creates the hire.
Show this field on client invoices: Prints the field's value on the client invoice. Fields with this setting on can also be used to group and sort invoices.
Restricted access (file upload fields only): Files in this field are visible only to admins and compliance users. Everyone else sees "Restricted: only visible to authorized users".
After completing all fields, click Save to activate the custom field.
Payment request custom fields come in two types: timesheet custom fields, used on timesheet-based payment requests, and expense custom fields, used on each individual expense added to a payment request.
Who Can See a Custom Field?
Custom fields are either internal (visible only to your own team) or shared with people outside your team. When you view a job custom field, a badge shows whether it is internal or shared, so you know who can see the value.]
Workers and staffing agencies: Internal fields are not shown to them. Fields used for worker or staffing agency onboarding are shown in their onboarding checklist.
Hire fields completed by the worker: Shown to the worker (or their staffing agency) on the draft hire. Other hire fields stay internal.
Sharing job fields with staffing agencies: You can share job custom fields with staffing agencies so they can read the values on the job.
Fields shared with clients: When a staffing agency or MSP sets up a field and marks it as shared with the client, the client can see and edit it on the job and, after the hire is created, on the hire.
Timesheet fields on MSP hires: Workers on hires sourced through an MSP or supplier see the end client's timesheet custom fields, so the client's required information is collected.
Expense fields: Always visible to workers (and to staffing agencies on agency-managed hires), and always shown on client invoices. On supplier → client payment requests, the values are copied across to the client's payment request and invoice.
Restricted files: File upload fields with restricted access are visible only to admins and compliance users.
Custom fields in timesheet imports
If you upload timesheets in bulk, the import checks each row's timesheet custom fields with the same rules as the payment request form, both in the preview (dry run) and when you confirm.
The downloadable CSV template includes a column for each timesheet custom field on your hires.
Dropdown: enter the option exactly as it appears in Worksome. A value that isn't an existing option rejects the row – the import doesn't create new options.
Date: use the format YYYY-MM-DD.
Yes/No: use yes/no, true/false or 1/0.
A missing value in a required field rejects the row, and the results name the field.
Multi-select and file upload fields can't be imported. If one is required on a hire's timesheet, every row for that hire is rejected.
On MSP or supplier hires, both the client's and the MSP's worker-visible timesheet fields apply.
How to manage Custom Fields
Managing Custom Fields
Once created, custom fields can be managed in Company Settings > Custom Fields. Here, you can:
Add: Set up new fields as needed.
Edit: Adjust names, descriptions, or settings of existing fields.
Archive: Retire a field you no longer need, such as an old monthly field.
Delete: Remove fields no longer in use. Deleting also removes the field's recorded values from the platform and from exports. Use Archive instead unless the field was created by mistake.
Filtering by custom fields
You can filter the talent pool, applicants, staffing agency and jobs tables by custom field values.
Need Help?
If you have any questions or need further assistance, reach out to our support team via chat (just click the button in the corner) or email us at hello@worksome.com. We're happy to help!

