website logo
ChartHop documentation
Carrot reference
Release notes
Navigate through spaces
ChartHop documentation
Carrot reference
Release notes
⌘K
Welcome
Welcome to ChartHop documentationšŸš€
Available ChartHop packages
Getting Started
ChartHop Video Library
Navigating ChartHop
ChartHop terminology
Markdown formatting
Filtering data
Home page
Visualizing your organization
Org Chart
Map
Data Sheet
Employee Profiles
Setting up ChartHop
Creating your ChartHop org
Importing spreadsheet data
Configuring your Org settings
User management
Permissions and security
Creating and managing groups
Customizing ChartHop
Forms
Fields
Customizing employee profiles
Document templates
ChartHop apps and bundles
ChartHop apps
ChartHop bundles
Performance management
Performance reviews
Org management
About org management
Working with jobs
Working with people
Working with job history
Announcing org changes
Planning
Scenarios
Headcount planning
Compensation reviews
Legacy compensation reviews
Compensation bands
Viewing your people data
ChartHop reports
Partners
Sequoia getting started
Accessing ChartHop as a Sequoia customer
ChartHop first run guide for Sequoia customers
ChartHop features available to Sequoia customers
Troubleshooting common sync errors
Developers
ChartHop connect
Developer basics
Events
Syncing data to/from ChartHop
Resources
ChartHop Standard Terms and Conditions
ChartHop Basic Agreement
Data Processing Addendum
Privacy policy
Security statement
Subprocessors
FAQ
Docs powered byĀ archbeeĀ 

Customizing the Greenhouse app

Packages: Basic | Standard* | Premium

* Available as an add-on

You can customize some aspects of the Greenhouse integration app. With customizations you can configure your integration to better match your desired behavior.Ā 

Custom and default job template matchers

With job templates you can create detailed job postings that can be assigned to jobs in your Greenhouse integration.

Create a default job template matcher

You can specify a default template for your jobs in your Greenhouse integration app’s settings. The default template is used whenever a job in ChartHop does not match any of the criteria specified in the Template Matching Filter. Similarly, if no custom job templates are provided, all new Greenhouse Jobs are created using the default template. You can create a default template in order to account for jobs that do not have any specific criteria.

You can create a default template for all other jobs.
You can create a default template for all other jobs.

To create a default job template in ChartHop:Ā 

  1. Mark the existing job in Greenhouse as a template job.Ā 
  2. Create your default template job in Greenhouse.
  3. In ChartHop, navigate to Apps from the settings (gear) menu in the left side bar.
  4. Select the All Apps tab.
  5. Scroll the list down to the Greenhouse app.
  6. Select the Greenhouse app.
  7. From the ChartHop Greenhouse app settings page, enter the name of your default template under the Default Template Name.

Create a custom job template matcher

With a custom job template, you can specify what job template to use when creating a new Greenhouse Job if no match is found. This allows you to include additional information, such as the job’s description.

To create a custom job template in ChartHop:Ā 

  1. Mark the existing job in Greenhouse as a template job.Ā 
  2. Create your template job in Greenhouse.
  3. In ChartHop, navigate to Apps from the settings (gear) menu in the left side bar.
  4. Select the All Apps tab.
  5. Scroll the list down to the Greenhouse app.
  6. Select the Greenhouse app.
  7. From the ChartHop Greenhouse app settings page, in the Template Matchers section, select + Add Template Matcher to create a new template matcher.Ā 
  8. Enter the template name using the same name of the template you made in Greenhouse.

Because your ChartHop template name must exactly match the job template name in Greenhouse, we recommend that you copy and paste the name to avoid any errors.

Customize your filters

After entering in the template name, you can customize your filters based on any ChartHop field. By clicking on the Add Filter button, you can build custom logic to determine when the template is used. For example, in the picture below, we are specifying that any job title containing the words ā€œdata scienceā€ should use the ā€œData Scientist Templateā€ in Greenhouse.

Use the filter button to create special filtering criteria for your template.
Use the filter button to create special filtering criteria for your template.

When a new job is created in Greenhouse and no existing matches are found, the Greenhouse job contains additional information attached to that job template, such as the job post, job description, and interview plan.

Test your job template matcher

You can test your templates to ensure that your open jobs are properly selected. This allows you to perform a manual check of your filter criteria to see what existing ChartHop Jobs match that criteria by highlighting them in the Data Sheet.

Select the Test button to filter the Data sheet based on your Template Matching Filter.
Select the Test button to filter the Data sheet based on your Template Matching Filter.

To test your job template filter:

  1. Navigate to Apps from the settings (gear) menu in the left side bar.
  2. Select the All Apps tab.
  3. Scroll the list down to the Greenhouse app.
  4. Select the Greenhouse app.
  5. From the ChartHop Greenhouse app settings page, in the Template Matchers section, select + Add Template Matcher to create a new template matcher.Ā 
  6. Paste your Greenhouse template name in the Template Name field.
  7. Enter your Template Matching Filter.
  8. Select Test.
The Data Sheet displays your job data based on the previous filter.
The Data Sheet displays your job data based on the previous filter.

If your test is successful, you can see a filtered Data Sheet containing all jobs in ChartHop that match your criteria.

Create custom field mappers

Custom field mappers can be used to map additional custom fields between Greenhouse and ChartHop.Ā 

You can use custom field mappers to override the default field mappings. For example, you can pull a custom field into a ChartHop default field. Similarly, you can disable default field mappers. For more information about managing custom fields, please contact your ChartHop implementation specialist.

You can use custom field mappers to override the default field mappings.
You can use custom field mappers to override the default field mappings.

To create a custom field mapper, follow these steps:

  1. Navigate to Apps from the settings (gear) menu in the left side bar.
  2. Select the All Apps tab.
  3. Scroll the list down to the Greenhouse app.
  4. Select the Greenhouse app.
  5. From the ChartHop Greenhouse app settings page, scroll down and select the Add Field Mapper button.
  6. Enter your Greenhouse custom field code name under Remote Fields, appended with the correct endpoint.
    • To ensure that your Greenhouse field parses correctly, your Remote Fields must be preceded by the correct endpoint (job., offer., etc.), and structured as follows:
      • The endpoint (such as job) + custom_fields. + your Greenhouse Immutable Field.
  7. In the ChartHop Field, enter the field or Carrot expression you wish to map to the previously entered Greenhouse custom field.
  8. (Optional) You can overwrite an existing default ChartHop field with your custom field. We recommend that you contact your ChartHop Implementation Specialist before trying this.

As an example, if you wanted to map a ChartHop custom field like targetSalary to the Greenhouse custom field targetBase, then you’d want to set up your field mapper like in the image below:

The custom ChartHop Field: targetSalary is mapped to the custom Greenhouse Remote Field: targetBase.
The custom ChartHop Field: targetSalary is mapped to the custom Greenhouse Remote Field: targetBase.

To avoid failed mappings, be sure to double-check the names of the custom fields you are using.

Updated 24 Nov 2022
Did this page help you?
Yes
No
UP NEXT
Adding Greenhouse Jobs
Docs powered byĀ archbeeĀ 
TABLE OF CONTENTS
Custom and default job template matchers
Create a default job template matcher
Create a custom job template matcher
Customize your filters
Test your job template matcher
Create custom field mappers