Gitlab hero border pattern left svg Gitlab hero border pattern right svg


For all Greenhouse users

How to join Greenhouse

Greenhouse is GitLab's ATS (Applicant Tracking System). All hiring managers and interviewers will use Greenhouse to review resumes, provide feedback, communicate with candidates, and more.

You will receive an email to log in to Greenhouse for the first time. When you log in to Greenhouse, enter your GitLab e-mail address and click next and fill in your Okta information as prompted. All GitLab team-members are granted basic access, which will allow them to add and track referrals and share job postings on social media. Until their access is upgraded by an admin, they will only have access to one page in Greenhouse, Dashboard, where employees can make referrals.

During onboarding, all new team members are added to Greenhouse based on their role in hiring. If a current team member needs to change their access level, they will need to create a new access request issue in the GitLab access-requests project, and their manager and the recruiting team will be pinged to approve and action it.

Your dashboard

The Greenhouse dashboard will be your main hub for activity when in Greenhouse. All team members have access to this page, but depending on your role in the hiring process you may have more contents on this page than others. All team members can see the "Add a Referral", "My Referrals", and "Share Jobs with your Social Network" section (all of which are described in more detail below). On the righthand panel, there is a section called "Helpful Links" which will bring you to various links across Greenhouse, as well as the Greenhouse support team.

Members of a hiring team may have additional sections, such as "My Interviews", which contains a snapshot of your next three scheduled interviews, with a link to the candidate's profile and interview kit; you can click "See All Interviews" to view your full list of upcoming interviews and "See Past Interviews" to view your completed interviews. You may also see "My Follow-up Reminders" section, where any upcoming reminders for you will sit.

Recruiters will see an additional section "Applications to Review" which will have a list of their roles with a link to the application review functionality, where they can quickly review applications and advance, decline, or submit feedback. This panel shows only the five roles with the most pending applications, but you can click "See All" and choose a role that you are responsible for beyond this list. Hiring managers do not have this section on their dashboard; however, they can access application review by going to the job dashboard for their vacancy and clicking on "Application Review" on the righthand panel.

On the righthand panel, members of the hiring team can see a list of "My Tasks" and "All Tasks" which shows how many candidates you have a pending action item on, such as "Needs Decision", "Candidates to Schedule", "Take Home Tests to Send", or "Offers". You can view the full list of pending tasks by clicking "All Tasks".

Members of the approval process (i.e. executives, Finance, and People Ops) will have an additional section titled "My Approvals" which will contain a list of any candidates or new vacancies that are pending their approval.

There is also a quick link to "People I'm Following" so if you are following any candidates you can quickly get to their profile. To follow a candidate, go to their profile and click "Follow" on the right side. You can also choose to follow someone when you refer them.

Next is a section called "Helpful Links", which includes a link to our internal job board, a link to a list of our "in-house contacts" (which are GitLab team-members who are our Greenhouse account owners) with their names and emails, and a link to the Greenhouse help center.

The last button of note is the "Personalize Dashboard" button at the bottom of the righthand panel. You can use this to adjust your settings on your dashboard to hide or rearrange sections to streamline your workflow.

Sharing vacancies on social media

If you would like to share a job posting with a particular person or on social media, you can do so via the "Share your link with people interested in working at your company" option on your Greenhouse dashboard. Simply choose the vacancy you'd like to share, copy the link, and share it as desired. To note, sharing a link with someone or on social media does not count as a Referral and is thus, not eligible for the Referral Bonus.

You are able to share any or all of our current vacancies through social media by connecting your Greenhouse account with your social media accounts, such as LinkedIn and Twitter.

To connect to your social networks, go to your dashboard and scroll to the Share Jobs with your Social Network section. Click to connect to the desired platforms. Once you've clicked that button, you'll be redirected to the chosen social site and asked if you'll allow Greenhouse to "Post updates and view your basic profile information" (you can withhold this at any times in either your Greenhouse or social media settings). Upon accepting, you'll be taken back back to your Greenhouse dashboard.

Under the Social Network section, you'll now see options to share the vacancies. To post a vacancy immediately, click "Post" next to the platform that you'd like to post on, then choose the vacancy to share, and adjust the verbiage in the share message. Please keep your message in-line with our values, follow our social media guidelines, and use inclusive language. There is a template, but we encourage you to personalize it to attract applicants!

You can also schedule posts to your social media by clicking the "Schedule Posts" button. You can choose as many vacancies as you'd like. Choose when you'd like to share them (i.e. the frequency, days, and times), then adjust the verbiage of the message, and click "Schedule". Don't worry if you make a mistake or want to change something - you can customize or delete individual posts once they are scheduled. There will be a list of your scheduled posts in the Social Network section of Greenhouse.

You'll be able to see the total number of applicants that have applied through your links. Next to each social network you've connected, there will be a number showing how many posts you've made, how many candidates have applied, how many are currently active, and how many have been hired. Please note these candidates do not count towards the Referral program and will not show up under your "My Referrals" section. If you have a specific candidate that you'd like to refer, please be sure to follow the steps outlined on the Referrals page.

For all interviewers

Application review for interviewers

All applicants begin our hiring process in the Application Review stage. If you're an interviewer for a role, you may be part of the review process with the goal of identifying applicants of interest. If this is part of your responsibilities as an interviewer, we recommend the following:

  1. Evaluate new job candidates for your jobs often. You can see a list of jobs you're an interviewer for by clicking "All Jobs" in Greenhouse.
  2. Note the recruiter for each of your jobs. After clicking on a job in Greenhouse, you should have access to two tabs as an interviewer: "Candidates" and "Job Setup". Click "Job Setup" and scroll to the "Hiring Team" section to find the recruiter for a job.
  3. Provide the recruiting team with your feedback on candidates:
    1. Click on individual candidates in either the "Candidates" tab if viewing a specific role, or "All Candidates" for all candidates you're an interviewer for.
    2. Click "Application" on the left side of an applicant's profile to view their resume and cover letter if provided, and below the documents click "Job Post Questions" to expand and view their answers to the job's application questions. If there are no job post questions answered, the candidate was likely sourced or exported from an internal job board and would need to have the questions sent to them, which you can either send or tag your recruiter to send.
    3. Evaluate the candidate's resume, cover letter, and job post questions while being mindful of our hiring principles. Leave your recommendation on the candidate as a note in the "Make a Note" area in the right sidebar and tag the recruiter for the role.
    4. If the candidates does not meet the requirements of the role or if other candidates are better qualified, you are welcome to directly decline the candidate by 1) Selecting "Reject" 2) Selecting the "Rejection Reason" and adding notes if applicable 3) Selecting the appropriate rejection e-mail template 1. Please use the "Default Candidate Rejection" template and send from 1. For referred candidates, please select the "Reject referral after resume review" template and ensure it is coming from you so the referred candidates have a point of contact should they require reassigning for the rejection.

Mentioning the recruiter for this role is sufficient, and leaving a detailed scorecard is not necessary for the Application Review stage.

Note that these steps may be different for hiring managers.

Feedback and interview kits

When you have an interview, you have two ways to get to your interview kit to leave feedback for a candidate. The first is by clicking the link in the calendar invitation for the interview. The second is by going to your Greenhouse dashboard where you will see a list of your upcoming interviews and can click "See Interview Kit".

The interview kit consists of a few tabs:

Additionally, the interview kit shows the candidate's name, contact details, pop-out links to their resume, cover letter, and other details, as well as the details for the interview (location, time, etc.) on the lefthand side. It also includes the role the candidate is interviewing for at the top of the page.


The scorecard consists of a few elements. There are text boxes where you can add in your notes. Some scorecards for different roles or stages may have additional text boxes for specific questions. If a text box is required, there will be a red asterisk by the question.

Underneath the first text box "Key Take-Aways", there are two additional links, Private Note and Note for Other Interviewers, which will open additional text boxes if you click on them. Private notes are typically only used by the recruiting team when collecting compensation information and are only viewable by the recruiting team and hiring managers for the role. The note for other interviewers text box is extremely useful to all interviewers, as this is a place where you can include any information that you think would be relevant in future interviewers, including areas to dig into, further evaluate, or look out for. Any notes you put in this text box will appear in the next interviewers' interview kit on the "Interview Prep" tab.

Below the text boxes for notes, each role has a list of attributes that we are looking for. Each stage in the process has certain attributes highlighted that it's recommended for you to evaluate; however, no attributes are required, so you can feel free to rate any attributes you've gained insight into. All stages include attributes for values-alignment, which all interviewers are heavily encouraged to complete, so we can assess values-alignment for each candidate.

Below the attributes is the final piece where you will make your decision. Greenhouse says "Overall Recommendation: Did the candidate pass the interview?"; this should be interpreted as "Do you want to hire this candidate?" and answered appropriately. The final score is not required by Greenhouse, but it must be completed by the interviewer. If the interviewer does not add their vote, the recruiting team will follow up with them to include their vote. If you are on the fence about a candidate, that is typically an indication that you do not want to hire the candidate, but if you are really unsure feel free to reach out to your recruiter to discuss further. Your recruiter may agree with your hesitations and decline, or you may agree that there is an element that should be further explored in an additional interview.

Your scorecard will automatically save as you enter information, and record that it saved it the top righthand corner. If there is an error and Greenhouse is not able to save the scorecard, it will say so at the top righthand corner and you'll be unable to submit your scorecard. You can either wait until it does save, or open the interview kit again and copy/paste the information over. If you have further issues, please reach out to the recruiting team.

Finally, click Submit Scorecard and you're done! From there, you may go back to review and edit your scorecard, view the candidate profile, or return to your dashboard. In order to ensure a timely response for each candidate and to reduce the possibility of forgetting important details and impressions of the candidate, all Scorecards should be submitted within 3 business days of the interview.

In order to help remove bias, interviewers (unlike hiring managers) are not able to see others' scorecards until after their own scorecard has been submitted. If there are certain flags or notes that should be highlighted to the rest of the interview team, the interviewer should add a note in their scorecard by clicking the "Note for Other Interviewers" section right underneath the "Key Take-Aways" text box in their scorecard. You are also able to add notes outside of your scorecard that will be visible to future interviewers by going to the candidate profile and to the text box on the right side under "Make a Note", adding your note, and checking off the radio button to make it "Visible to Interviewers".

Interview notifications

You can set up reminders in Greenhouse by going to your account settings and turning on Daily interview reminder email which will email you each morning with a list of your interviews for the day. You can also connect your Slack account to your Greenhouse account and receive reminders after the interview is over if your scorecard is still due, as well as other notifications depending on your settings.

Searching candidates

Since we have a great pool of talent within our ATS, Greenhouse enables the hiring teams to search for specific attributes of candidates. To search for keywords, go to the candidates tab at the top of the Greenhouse website, use the search bar on the lefthand sidebar to input your keywords, and enable to option "Full Text Search".

A popular method of searching is using boolean queries which allows you to combine keywords or phrases to get more relevant results, such as engineer AND "ruby on rails". All fields in a candidate resume, application, forms, and more are searchable, and you're able to filter even further using Greenhouse's filter tools on the sidebar.

Email syncing

All email communication with candidates must be kept in Greenhouse. Only Job Admins (hiring managers, executives, and people ops) are able to email candidates from Greenhouse; if you are not a job admin and want to email your candidate, please reach out to your recruiter. In order to ensure that the candidates' responses are also kept in Greenhouse, you have two options, as there is no automatic sync. The first option is to use a Google Add-on "Greenhouse for Gmail" which will allow you to sync any emails you receive from within your Gmail inbox. The second option is to either bcc your outgoing email or forward your received email to

Leaving notes

It's always recommended to leave notes in a candidate profile to maintain communication between the hiring managers, interviewers, and recruiting team. To leave a note, go to a candidate profile, and on the right side under "Make a Note" type your note, tagging anyone you want to view this note. If you do not tag anyone, no one will receive a notification and it may be lost. Once you're done with your note, click "Save" and it will notify anyone tagged and be logged in the candidate's profile under "Activity Feed", where anyone who has access to the role can view it.

Private notes should only be used to discuss compensation or other confidential items related to the candidate, but this information should always be kept in private notes. To leave a private note, go to the candidate profile, click "Private" under their name, scroll to the bottom and click "Add Private Note". Be sure to tag anyone you want to be notified, but be aware that only Job Admins (i.e. not interviewers) are able to view private notes. All Job Admins including hiring managers are able to see private notes whether or not they are tagged.

Access to roles

If you need access to review or interview candidates for a vacancy, please reach out to the recruiting team, either through Slack or email. The recruiting team will verify with the hiring manager for the vacancy, and then provision access accordingly.

For hiring managers

What access do I have?

As a hiring manager or executive, you have access to view all candidates for any vacancies you are marked as a Hiring Manager for, as well as all private notes for any of those candidates. While interviewers are restricted in that they are not able to see previous notes or feedback for a candidate when they are scheduled for an interview, hiring managers do not have that restriction and are able to see all notes and feedback at any point in the process. Hiring managers are not able to view candidates anymore once they are hired, or any candidates outside of the role they are a hiring manager for.

How do I view my roles and candidates?

When you log in to Greenhouse, you will see your dashboard; however, this will not paint the full picture for all of your roles. In order to view the status of your current vacancies, click "All Jobs" at the top of the page, then choose whichever job you want to review. There will be an indicator if you are the hiring manager for a role or not below the job name, and you will only be able to view the jobs you have access to as a member of the hiring team for that role; please note the below details are only accessible to Job Admins, and Interviewers have less functionality available to them.

After you click on a job, you will be brought to the job dashboard for that specific job, which contains all of the information you should need. At the top of the page, there is a quick snapshot of application trends, showing you how many applications you've received, how many have been rejected, and how many are active. Below that you can see a snapshot of the sources where you are getting your applicants as well as the average quality of the applicants from each source. Next, you'll see a list of any candidates you're following in this role. The last section on this page is "Pipeline Tasks" where any pending tasks for candidates in this role will be shown. You can also view a less detailed version of this task list at the top right sidebar on this page, where you can easily click "Review Applications" (which is the quickest and easiest way to bulk review applications) or click on the number next to each stage to view the candidates in each stage. If you wanted to view all candidates regardless of stage, simply click "Candidates" right above the "Application Trends" section (not the "All Candidates" at the very top of the page). Below the snapshot pipeline at the right sidebar, you can view any prospects for this role, Greenhouse predictions of when the role will be filled, and finally job setup links that enable you to adjust the settings for the vacancy. It's recommended for only the recruiting team to edit the vacancy setup, but please reach out to them if you have any questions.

If you want to review the candidates for multiple jobs at the same time, click "All Candidates" instead, and then use the filter on the left sidebar, Jobs > Filter by Job > select the appropriate jobs. You can use the filters to further narrow down candidates.

Configuring notifications

Notifications are configured as part of the vacancy creation process but can be adjusted at any time. To set up notifications, go to the vacancy's job dashboard and click on "Job Setup" at the top, then "Notifications" at the left. Under each section, you can then click "Edit" to add or remove yourself for that section.


Hiring managers have the ability to quickly view and pull reports for their vacancies. To do so, go to the job dashboard of the vacancy you want to report on. Then, click "Reports" below the vacancy name. From there, it will show you a variety of different reports you can pull depending on what you're looking for, and each one will dynamically show you the report which you are able to use some filters on. You're also able to save reports to come back to them later, share a report via email to set up recurring reports to have reports emailed to you or someone else on a weekly basis, and to download the report as an excel file for easy sharing through Google Sheets.

Application review for hiring managers

To access application review for your candidates, go to the job dashboard for the vacancy you want to review. On the right sidebar, under Pipeline, you can see how many applicants are in application review and click "Review Applications" to be taken to a portal that shows each candidate's name (which is an active link that will open a new tab to the applicant's profile), application date, answers to application questions, resume, cover letter, and any other details of their application. The application review will show you the applications with the least recent activity (whether that is their application date or any activity on their profile took place), so you can work your way from oldest to newest. You are able to advance, skip, or reject applicants, as well as leave feedback with any of those decisions. It's recommended to always include feedback when reviewing applications so the recruiting team is aware of your thought process. It is perfectly acceptable to skip candidates you are not sure of and tag your recruiter in the feedback section for them to review and take action on. If you do advance an applicant, be sure that your recruiter either receives notifications when candidates change stages or tag them in feedback and ask them to move forward (the safest option). If you reject a candidate, always be sure to send the candidate an email using one of the templates. You can also "skip" the candidate and leave feedback for the recruiter to reject, which is recommended.

To view the application questions of a candidate outside of the application review portal, go to their profile, click "Application" on the left side, scroll down and expand "Job Post Questions". If there are no job post questions for the candidate, it is likely they were sourced or imported from an external job board, so you can feel free to send them the job post to answer these questions.

For Recruiting

Access levels and permissions

Greenhouse has a variety of user-permissions for ensuring that team members have the appropriate access per assigned vacancies. By default, any Job Admin will have the following permissions on an assigned vacancy:

Below is a list of the various access levels, by team, and what they generally entail:

There are a few other permission levels in Greenhouse that are not frequently used:

To note, if a vacancy is marked as "Closed" in the Job Setup > Job Info > Job Status, then Interviewers only will not be able to see any candidates in that vacancy.

How to upgrade or change access levels

Only Admins can upgrade another team member's access level. During onboarding, all new team members are added to Greenhouse at the appropriate level listed above. If a current team member needs to change their access level, they will need to create a new access request issue in the GitLab access-requests project.

The default access level is "Basic", but anyone reviewing and interviewing candidate profiles should be upgraded to the "Interviewer" role. To upgrade access levels:

  1. Go to settings and click on users
  2. Search for the team member in the search bar; if their name appears, click on their name
  3. Click "Edit" in the permissions section. Choose the "Job Admin/Interviewer" option
  4. Click "Add" under "Job-Based Permissions"
  5. Search for the job they should have access to and click "add" next to it, then choose "Interviewer"

For any team members who are hiring managers (or above), choose "Job Admin: Hiring Manager" for the specific roles they should have access to; if they are a hiring manager for an entire department, they should also be added as "Job Admin: Hiring Manager" for future roles within that department. If they are a hiring manager or above for a role, they should always be marked as "Job Admin: Hiring Manager" and not "Interviewer" even if they will be interviewing, since that will limit their access. Meanwhile, the executive for a division (e.g. CRO, CMO, VPE, etc.) should receive "Job Admin: Job Approval" for all of their division's current and future roles in order to give them the same permissions as "Job Admin: Hiring Manager" as well as the ability to approve new vacancies.

Similarly, Recruiting receives "Job Admin: Recruiting" for all current and future roles; People Ops receives "Job Admin: People Ops" for all current and future roles.

There are additional "User-Specific Permissions" listed beneath the job-based permissions.

  1. For hiring managers and above, always check off "Can create new job stage names (Job Admin only)".
  2. For the people ops team, check off "Can invite new users to Greenhouse and reactive disabled users", "Can manage unattached prospects", and "Can invite and deactivate agency recruiters".
  3. For the recruiting team, check off each additional option.
  4. Site Admins should typically have access to all of the additional options, but always be sure to check off "Can see EEOC and demographic reports", "Can create and view private candidates", and "Can see private notes, salary info, manage offers, and approve jobs/offers".

Adding an agency recruiter to Greenhouse

To add an agency recruiter to Greenhouse and their agency doesn't exist, then a new agency will need to be created. If the agency does exist, this is how to add a new recruiter.

If an agency recruiter will be advancing- and/or declining candidates, then they'll need an Okta account in order to have Job Admin permissions.

To provision an Okta account:

Linking users to their profiles

All hired candidates are marked as private when they are hired. Meanwhile, all Site Admins, Job Admins: Recruiting, and Job Admins: People Ops have access to view private candidates. As a result, any new team members who fall into one of those permission levels needs to have their Greenhouse user account linked to their candidate profile. Please note only Site Admins can link a user to a candidate profile. To do so, go to settings, click on users, search for the team member in the search bar, click on their name, click "Link to Candidate", then search for the team member's name again, and click "Link" on the appropriate profile, then scroll to the bottom and click "Save". You can also follow the instructions which include screenshots on Greenhouse's website.

Any internal candidate who applies to a vacancy via the internal job board will automatically have their user profile and candidate profile linked.

Enabling LinkedIn Recruiter System Connect

To enable the LinkedIn Recruiter System Connect integration, please follow the instructions in this how-to document. You will need to skip step two, as this setting is already enabled.

To note, you will need to have already added your GitLab email to your LinkedIn profile before being able to proceed.

To add your email, click "Me" > Settings & Privacy > Account > Email addresses > add your GitLab email address and verify it.

Configuring notifications

Notifications are configured as part of the vacancy creation process but can be adjusted at any time. To set up notifications, go to the vacancy's job dashboard and click on "Job Setup" at the top, then "Notifications" at the left. Under each section, you can then click "Edit" to add or remove people for that section.

It is recommended for the Recruiter of a vacancy to set up notifications for themselves regarding new internal applicants, new referrals, new agency submissions, approved to start recruiting, offer fully approved, stage transitions, and new scorecards.

For stage transition and new scorecards, it is possible to select Candidate's Recruiter or Candidate's Coordinator instead of a particular person for each stage, which is highly recommended.

Configuring email permissions

Greenhouse allows Job Admins to grant other Job Admins the permissions to send out emails on their behalf. This is helpful, for example, when a recruiter is sending out an availability request email but wants the responding email with the times to go to the coordinator so they can schedule next interviews, they could send the email from the coordinator's email address to ensure that happens. In Greenhouse, the activity feed on the candidate's profile shows who actually sent it and who it came from, so that it is clear.

In order to set up these permissions, the person allowing another person to send emails on their behalf should log in to Greenhouse, hover over their name in the top right corner, and click "Account Settings". Then scroll down to the section called "Email Permissions". You can select the first option to allow any Job Admin or Site Admin to send emails on your behalf, or you can select the second option and choose specific people (who are Job Admins or Site Admins) only who are able to send emails on your behalf. You can remove these users or this functionality at any time.

Once you have the permissions to send emails on someone else's behalf, when you are sending an email to a candidate, you can click the "From" button at the top of the email pop up and choose from the list of available email addresses. If you are using an email template, remember to choose the template and then change the sender, or the template will override any changes you've made.

Changing jobs

If a candidate applies for a job but is a better fit for another job, they will need to be added to a new job. There are a few options to do this; to start, go to the candidate profile and click "Add or Transfer Candidate's Jobs" at the bottom right. From there, you can either add a new job to the candidate profile, which will keep all data within the original job and start a clean slate for the new job. Alternatively, you can also transfer the candidate data to the new job, but this should be done with caution, as it will not transfer any scheduled (i.e. not completed and submitted) interviews or scorecards, and it will remove the candidate from any reports about the original job. Super Admins are also able to remove a job and its history from a candidate profile, which should be done only when absolutely necessary.


It is possible to add tags that automatically link to applicants when they apply based on their answers to certain application questions. To add an auto-tag to a vacancy, go to the vacancy's "Job Setup" page, then "Job Post". To the right of the vacancy name, there will be a link "Manage Rules". Click this, then click "Add a Rule". You can then select which application question on this vacancy and what answer you want to create the auto-tag for. (Please note: only application questions that are yes/no, single select, or multi-select may have auto-tags.) For example, you could choose the question "Do you have experience with Ruby on Rails?" and when an applicant answers "No" from the dropdown options. Then check off "Tag" and it will populate all current tags to choose from, such as "auto-reject", "no ruby experience", "needs visa", "no-hire country", etc. Once you've selected any and all tags you want to be associated with this question and answer, click "Save". If you want to create auto-tags for multiple questions and/or multiple answers, you will need to repeat this process.

Going forward, all new applicants whose answers in their application questions correlate to the rule you set up will automatically also have the tags you chose. To quickly find candidates, go to either "All Candidates" or the candidates for a specific vacancy, open the "Profile Details" section on the left sidebar, and under "Candidate Tag" select the appropriate tag. You can add additional filters as desired, and you can then perform bulk actions on these candidates by using the bulk function on the top right.

Scheduling interviews with Greenhouse

The recruiting team will schedule most interviews, which is a three-step process.

To schedule an interview, first make sure to move the candidate to the correct stage (Screening, Team Interview, Executive Interview, etc.), then request the candidate's availability by pressing the Request Availability button when viewing the stage. It is recommended that you modify the email with the general work hours of the interviewer for smoother scheduling. You are also able to provide suggested times that the interviewer is available by quickly pulling up their calendar within Greenhouse and selecting times. If you need to re-request availability (for rescheduling, scheduling a new interview in the same stage, etc.), click where it now says one of "Requested", "Received", or "Confirmation Sent" and choose "Request Availability". The button to request availability will now re-appear.

Once the candidate provides their availability, you will receive an email and can schedule the interview by clicking the "Schedule Interview" button on the candidate's profile next to the appropriate interview stage. Choose the interviewer and click the "Find Times" button at the top right, and find a free spot on the interviewer's calendar (making sure it is within their working hours). Note both the candidate's and interviewer's timezone for easier scheduling. DO NOT change the calendar's timezone from the drop-down view. Greenhouse will show the available times of the interviewee in white on the calendar. If you do not find a suitable time on the first day, you can change days by clicking the arrows near the current day. Note that Greenhouse does not currently update timezones once you change days, so you will need to reselect the timezone again even if it looks like it is selected in the timezone bar. When scheduling, be sure to not schedule more than 3 interviews per day for an interviewer. If you are not able to see their calendar, you can either check the "Interview Calendar" in Google Calendar to view if they have any other interviews that day or reach out to the interviewer to confirm. The only exception to not scheduling more than three interviews per day is if you are scheduling screening calls for a recruiter.

When sending out the calendar invites to the interviewers, the recruiting team will include a link to a Zoom room for all interviewers under the "location" field, which will follow this format: (e.g. Joe Smith's would be: This room will be each interviewer's consistent location for their interviews, and the naming convention is standard across GitLab for anyone with a Pro Zoom account. All interviews will be conducted via Zoom to maintain a streamlined hiring process. To create a personal Zoom Room for someone, please follow the instructions in the handbook.

Once a time is selected, you'll need to send the candidate an interview confirmation. You can do so by clicking the "Send Interview Confirmation" button, which will bring up an email template. Note that the timezone defaults to your timezone even on the candidate's side. Therefore, it is recommended to either do the conversion for the candidate to avoid confusion or highlight that it is in your timezone, not necessarily theirs. There are timezone tools you can use for timezone conversions. Be sure to update the template to the correct Zoom room for the interviewer, and always select the Include calendar files button below the email and then click Send Email.

Please be sure to include the role for both the interviewer and the interviewee so that each side is aware of who they will be speaking with. When sending out the calendar invite to the interview, the role the candidate is interviewing for should automatically populate in the title, but be sure to double check. When sending the interview confirmation email to the candidate, be sure to include the title of the person they will be meeting with, as this is not automatic.

At this time, it is not possible to bulk schedule candidates; however, it is helpful to filter the candidates under Pipeline Tasks > To be scheduled so you can see everyone who needs to be scheduled on the page and easily scroll through them.

Scheduling executive interviews varies slightly for collecting and confirming interview times and typically involves the executive's Executive Assistant.

Important scheduling and interview notes

Rejecting candidates

To remove a candidate from the active pipeline, they need to be rejected in Greenhouse, which is typically done only by recruiting. Any time a candidate is rejected, the recruiting team will email them letting them know, as they will not automatically be notified if we reject them. When clicking the reject button on a candidate, Greenhouse will open a pop up where you can choose the appropriate rejection reason, as well as a rejection email template. Feel free to adjust the template per the guidelines in the handbook. You can also select a time delay to send out the rejection email. Finally, you are also able to start a new prospect process for a candidate when rejecting them, in the event you want to reach out to them again in the future.

If you want to consider a candidate for the future, the best practice is to archive them with the reason "Future Interest"; however, you can also start a prospect process when rejecting them so they are including in a pool of future interest candidates for the role, or you can simply add a follow-up reminder for yourself, the recruiter, and/or the coordinator to reach out to the candidate in a certain amount of time.

Please ensure that if candidates are rejected or remove themselves from the process that all further scheduled interviews are cancelled either through Greenhouse or through the Google Calendar "Interview Calendar" in order to remove the calendar event from interviewers' calendars. Rejecting a candidate will not automatically remove the calendar event from an interviewer's calendar.

You can also reject candidates in bulk by going to the candidates page, filtering accordingly, clicking Bulk Actions at the top right, selecting the appropriate candidates or by clicking "Select All", clicking "Edit Selected", clicking "Reject" in the pop up, and following the same procedure as above to reject and email. Note: you can only choose one reason when archiving in bulk.

To unarchive a candidate, click "Unreject" on the candidate profile under the appropriate role.


We do not operate under a single-veto basis. This means that even if a candidate receives a "No," they still may be moved on in the interview process depending on the feedback submitted by the interviewer. The hiring manager is responsible for reviewing all scorecards and making the decision to move the candidate forward or not. As a good heuristic, two "No" votes will result in the candidate's rejection. A "Definitely not" vote should be carefully looked at, and in most cases this would result in the candidate's rejection.

In situations where scorecards greatly differ, it is helpful to meet with everyone who interviewed the candidate to better understand each interviewer's experience. The hiring manager can then evaluate each experience and make a collective decision.

While hiring managers are the directly responsible individual (DRI) for hiring decisions and are allowed to override interviewers, making great hiring decisions is part of their own individual performance and they will be held accountable for them.

Changing stages for a candidate

Each role has similar stages, with various interviews within each stage. Below is a typical outline of the stages:

On rare occasion, there may be additional or less stages than represented here, but these stages should be consistent as much as possible in order to maintain data integrity for reporting. The interviews within the stages can be adjusted as needed, as long as they follow the same names (e.g. there should only be one Peer Interview 1 across all jobs and not a Peer Interview 1 on one job and a Peer Interview One on another). If there is any doubt or confusion, feel free to reach out to the Recruiting Operations Team.

If a candidate will have more interviews in a stage than predetermined, you can add additional interview events as long as the candidate is in the stage where you need to add the additional event.

Please take caution when changing or deleting stages for existing vacancies. If a stage is deleted in a vacancy and candidates are scheduled for interviews on that stage, the interview will be deleted from Greenhouse. It will still exist on the Google Calendar, but it will need to be rescheduled through Greenhouse using one of the current stages for the vacancy.

Updating candidate information

To update a candidate source, go to the candidate's profile and, underneath the name of the job they're being considered for, click the pencil button. Where it says "Source", search for the correct source; some common examples are "Referral", "LinkedIn (Ad Posting)", "LinkedIn (Prospecting)", "Internal Applicant", and "Jobs page on your website". If you need a source that is not listed and you're not able to add a new source, reach out to the recruiting team. If you select the referral option or one of the outbound sourcing (also called prospecting) options (such as "LinkedIn (Prospecting)"), be sure to then select "who gets credit" by searching for the referrer or sourcer who found the candidate. Then click "Update Source". If they were referred or are an internal applicant, their profile will now have a highlighted field next to their name indicating this.

To update a candidate's personal details, go to the candidate's profile and click "Edit Profile" on the top right. You'll be able to change the candidate's name, current company, current title, tags, phone numbers, email addresses, social media accounts, websites, address, and education details. You can also go to the "Details" tab of their profile and click "Edit" next to "Info" as these fields are connected.

To update a candidate's assigned recruiter and coordinator, go to the candidate's profile and go to the "Details" tab, then scroll down to where it says "Source & Responsibility". Click the pencil icon that will appear when hovering over either the recruiter or coordinator, then update accordingly. (This can also be done in bulk if needed using the bulk actions button on the candidates page.) You can update their source in the "Source & Responsibility" section as well.

To add attachments or documents to a candidate's profile, go to their profile and to the "Details" tab, then scroll to the bottom where it says "All Attachments". Next to the appropriate job they are being considered for, click "Add file" and choose if it is a resume, cover letter, or other document, then click "Choose File" and upload the document from your computer. You can change the visibility of a document by clicking the three dots (…) above the document so that only Super Admins and Recruiting can view it. Please note that cover letters and resumes are by default public to the hiring team for that vacancy and cannot be made private.

Updating and creating email templates

The recruiting team and Site Admins are able to add and adjust email templates. To access the email templates, go to the configure section by clicking the gear at the top right corner, then click "Email Templates". It is possible to create personal templates that only the user can access under "My Templates", but we strongly recommend all templates be added to the "Organization-Wide Templates" section.

To edit an existing template, click the pencil icon next to the template, make necessary adjustments, and click "Save" at the bottom of the page.

To create a new template, click "+ New" to the right of "Organization-Wide Templates".

Greenhouse has also created a quick video to walk through email templates as a resource.

Updating vacancy and offer approval flows

There are two separate approval flows: one for creating a Vacancy and one for creating an Offer. Please note that only Site Admins are able to update or add new approvals in Greenhouse.

To configure approval flows, click the Configure section (gear icon) in the top right corner, then Approvals. There will be two columns; one for Vacancy "Job" Approvals (left) and the other for Offer Approvals (right). Each Department that either has a unique sub-deparment in Greenhouse or unique Executive should have its own section. For example, Customer Success and Sales are separate Departments and therefore require separate sections even though they're both under the same Executive. Similarly, G&A is a Department that has multiple sub-departments with multiple Executives, so each sub-department under G&A needs to be separated into its own approvals by the corresponding Executive (e.g. Finance for CFO, People Group for CPO, etc.). Approvals are always split out by the Executive.

To note, approval flows must be created prior to the creation of a vacancy or offer approval or it will not be submitted correctly.

To create a new section of approvals:

  1. Scroll to the bottom of the page and clicking Add Approval by office/department.
  2. Then choose what Department this section will be for (e.g. Sales for a Department that has only one Executive or Finance for a sub-department that has multiple executives).
  3. Do not select an Office and click Create.
  4. Click Add Approval Step under the jobs approval column. Then click Add and search for appropriate team member for Step 1 (as outlined below) and select their name. If there should be more than one team member, click Add again and search for and select their name. If you choose more than one person, you'll notice above their names is a dropdown that says "1 of 2 required" - keep this as is. If for any reason we do need both approvals, you can change it to have both be required. Click Save.
  5. Click Add Approval Step, then click Add and search for appropriate team member(s) for Step 2 (as outlined below) and select their name(s). Click Save.
  6. Click Add Approval Step, then click Add and search for appropriate team member(s) for Step 3 (as outlined below) and select their name(s). Click Save.
  7. Repeat steps 4-6 above for the offer approvals column.
  8. You are ready to start creating and approving vacancies and offers!

To change an existing section of approvals:

  1. Find the appropriate section, then hover over what you want to change.
    • If you want to change the participants in an approval step, click the Pencil icon, so that you can remove and/or add team members.
    • Hover over the team member's name and click the "X" to remove them.
      • If you want to delete an approval step in its entirety, click the "X".
      • If you want to change the order of an approval flow, click and drag that step to the appropriate placing.
Approval flows

For Vacancy "Job" Approvals, the approval chain is as follows:

For the Official Job Approval (a.k.a. 2-Stage Job Approvals), please list the Finance Business Parnters again (1 of 2 required).

For Offer Approvals, the approval chain is as follows:

For Director-level roles and above, please add a fourth step and list the CEO and CPO (1 of 2 required).

Please note that the approval order should always be In Order and not All at once (located at the top of each section).

Updating or adding new departments

Occasionally, the Finance team updates our organization's divisions and departments. We try to keep Greenhouse as aligned as possible to Finance's structure so that we can maintain accurate alignment and headcount planning.

Please note that only Site Admins are able to update or add new departments in Greenhouse. In order to update or add divisions or departments, log in to Greenhouse and go to the configure section by clicking the gear at the top right corner. Then click "Organization" and scroll down the the "Departments" section. You will see each current division listed and, when clicking on the expand button, each department that falls under that division.

To change the name of a division or department, click the pencil button next to it. Please note you are unable to have a division and department with the same name. To add a new division or department, click "New Department" and type in the name; if it is a new division, simply click create, but if it is a new department click the "Subordinate to" dropdown and choose the division it is associated to (for example, the "Security" department is a subordinate to the "Engineering" division).

There are currently two exceptions to the official divisions and departments, in order to keep things organized and clear for both applicants and reporting purposes. Firstly, "Customer Success" is its own division with subordinate departments instead of falling under "Sales". Secondly, "Engineering Management" is a department under "Engineering" instead of being portioned out to various teams.

Additional resources


Internal GitLab trainings were done on Greenhouse, for basic users, interviewers, and hiring managers. These trainings can be found in the GitLab Videos folder on the Google Drive and are only accessible to GitLab team-members, as there is confidential information contained within the videos.

Greenhouse has training material specifically for new Recruiters and Coordinators that cover what each team member needs to know while working with the system.

Greenhouse support

Greenhouse has a very robust Support Center, with articles, how-to videos, webinars, and more.

If you have a Product Enhancement Request or need to submit a Support Ticket, please reach reach out to the Recruiting Ops Team. Alternatively, you have three options to reach Greenhouse's Support Team directly

  1. By emailing
  2. By using the Live Chat feature from anywhere within Greenhouse (bottom left corner)
  3. By submitting a request on Greenhouse Support's Website.

To note, when contacting Greenhouse's Support Team directly, please cc Erich Wegscheider on all tickets.

Greenhouse Inclusion

We use Greenhouse Inclusion to mitigate unconscious bias, ensure consistent candidate evaluations, and to measure the impact of these practices in our Diversity & Inclusion efforts.

Enabled features include: