Skip to main content
Use custom field mapping to translate your Ashby Offer custom fields into ClearOffer fields. When an offer is created or updated in Ashby, ClearOffer will fill in matching fields automatically.
Mappings only apply to offers that were created via the Ashby Integration. Existing offers created without using the Ashby integration aren’t retroactively changed.After creating a custom field mapping, you will need to make a new update to an offer in Ashby for the mapping to take effect.

​
Add or edit a mapping

1

Open ClearOffer

Open ClearOffer and click on the Company toggle in the sidebar, then click on Integrations to open the Integrations page.
2

Show Custom Fields

Within the Ashby card, click on the Show Custom Fields button.
3

Add Mapping

Click Add Mapping, enter the exact Ashby custom field name, then choose a ClearOffer field from the dropdown.
Field names must match Ashby exactly (including spaces and casing).
4

Edit or delete

Use the row actions to update or remove a mapping. Deletions require confirmation.

​
Rules and recommendations

Mapping rules

Each ClearOffer field can be mapped at most once.Each Ashby field name can appear at most once.

Best practices

Use simple, unambiguous Ashby field titles.Test with a single offer before rolling out broadly.

​
Available ClearOffer fields

  • Candidate First Name
  • Candidate Last Name
  • Job Title/Role
  • Department
  • Location
  • Reporting To
  • Base Salary Override
  • Currency
  • Payment Frequency
  • Welcome Message
  • Start Date
  • Expiration Date
  • Equity Shares (Number)
  • Equity Type
  • Years Vesting
  • Cliff Period (Months)
  • Strike Price
  • Preferred Price
  • Outstanding Shares
  • Company Valuation
  • Commission Type
  • Commission Target Amount
  • Commission Base Rate
  • Commission Quota Amount
  • Commission Payout Frequency
  • Commission Has Accelerators
  • Commission Details
  • Bonus Type
  • Bonus Name
  • Bonus Amount
  • Bonus Amount Type
  • Bonus Currency
  • Bonus Frequency
  • Bonus Description

​
Examples

Map department

Ashby Department → ClearOffer DepartmentKeeps your org structure consistent between systems.

Import equity details

Ashby Equity → ClearOffer Equity Shares (Number).ClearOffer will create equity details using your company defaults when values aren’t provided.

​
Troubleshooting

  • Confirm the Ashby field title exactly matches what’s in Ashby, and it is an Offer custom field
  • Ensure the offer was created/updated after the mapping was saved
  • Verify the relevant webhook event (Create/Update) is enabled in Ashby
The UI blocks duplicate Ashby field names and duplicate ClearOffer fields to avoid conflicts.
Ensure Equity Shares (Number) is a Number field in Ashby. Non-numeric values can’t be imported.

​
See also

Connect Ashby

Set up the Ashby integration and verify your connection.