Import Time Off Data

How do I import time off data?

Purpose: To teach you how to use the time off importer to import time off details of multiple employees at once.


Do you prefer hands-on learning? Our interactive guides will guide you through different aspects of your BambooHR experience. We have an interactive guide specifically designed to show you how to import time off data. You can use the link below to access this guide. All you need to do is modify the "REPLACEME" with your BambooHR subdomain,  and you can get started!

https://REPLACEME.bamboohr.com/home?pendo=j_gqe-tX8O4s_5NgPRvQdch2qmw 

**CAUTION: Whenever using the importing feature, we recommend running a test import of a single line to catch any formatting errors in the prepared data. Once you have imported the single line data, double-check if the data has entered as expected, and then continue to import the remaining data.

Time Off settings

When you need to add a large amount of time off information to BambooHR, you can use the time off importer to help you get this information added more efficiently. The time off importer can import the following time off information of your employees:

  1. Policy assignments
  2. Opening balances
  3. Balance adjustments
  4. Time off requests

To access the time off importer, go to Time Off in Settings, click Overview, and click on the gear icon. Select Time Off Import...

Download the time off template

Select the type of information you would like to import in the drop-down menu. Then, select import template file.

Because there is specific information required for each import, we have created a template for you to fill out. You can add columns to the template for reference purposes (i.e., Employee Name). Note that you can only import the columns that are in the downloaded template.

Complete the policy assignments template

To avoid errors, we recommend importing your data templates in the following order:

  1. Policy Assignment
  2. Opening Balance
  3. Balance Adjustment
  4. Time Off Requests

You are now ready to fill in the downloaded template. Please note that the example above is the policy assignment template, and you can find detailed information about all other time off import templates at the end of this article.

For the Policy Assignments template, enter the following data:

  1. Employee Name: I have added this column to the template for reference purposes only. This column will not import.*
  2. Employee #: The exact Employee # listed in BambooHR.*
  3. Accrual Policy: The name of the time off policy (not the type category name).  You must enter the policy name exactly as it appears within BambooHR.
  4. Time Off Category: The time off category associated with the policy.
  5. Accrual Start: The date that you want the system to start accruing time off for an employee. For example, in row #2, Charlotte Abbott is being assigned the Vacation policy as of 1/1/2023. This means that the system will activate this policy and will start accruing as of 1/1/2023. Please note that dates must be in a format with the four-digit year.

After entering all of the appropriate data into the template, save the file as a .csv  or .txt file. It is then ready for import. (See importing steps above.)

*Note: An easy way to get the Employee Name and Employee # into the template is to copy and paste the information from a custom report in BambooHR.

When assigning policies through import, all accruals and carryover loss will appear after a nightly system update at 1:00 a.m. (Mountain Time). You can use the calculate future balance tool to review changes before a nightly update.

Time off importer

Navigate to the Importer

To import your time off information, follow these three steps:

  1. Select the import type you want to complete.
  2. Click Choose File and select your .csv or .txt file from your computer.
  3. Click Upload File.

Match your data

After you have uploaded your file, map the data in the template to the corresponding fields within BambooHR.

  1. Import File Column: The column headers (Row 1) from your template.
  2. BambooHR Field: The fields that your data will import into within BambooHR. Since you have downloaded the template directly from BambooHR, the fields have matched up already. Note: If you have added any columns to the template (such as the Employee Name column), you will not import them, and make sure to select Do not import this field as shown above.
  3. Sample Data: The data from Row 2 of your import template. Double-check the data to ensure it looks correct.

If everything looks good, click Import.

Import results

After you have completed an import, a confirmation message will show. A green confirmation message will show if you imported all lines successfully. An orange-colored alert will show if any rows have errors. Click Show import details to display specific row-by-row information.

What to do if you get a Time Off error while importing
Time Off Error Message: "Employee is not assigned to the specified category."

What's going on: You may have tried to import an opening balance, balance adjustment, or time off request before the policy assignment import. Make sure you have assigned employees to policies before attempting any other import types.

Time Off Error Message: “Policy effective date is before employee hire date”

What’s going on: The Time Off Accrual Start Date, or policy effective date, cannot be before the Hire Date.

Time Off Error Message: “This policy doesn’t exist”

What’s going on: Time Off Policy name does not match the settings. The spelling, spacing, and capitalization must match exactly to settings.

Time Off Error Message: “Time off category not found”

What’s going on: Time Off Category name does not match the settings. The spelling, spacing, and capitalization must match exactly to the time off category in settings.

Time Off Error Message: “Employee already has this policy”

What’s going on: This error comes from the Policy Assignment importer. If you are not trying to assign a new policy, you may need to use a different time off importer option to accomplish your needs. Review the Time Off tab for the employee to verify the correct policy is assigned. 

Time Off Error Message: "Could not parse the date."

What's going on: This error happens because the date is not in a proper format. Make sure that your dates are listed as MM/DD/YYYY.

Time Off Error Message: "An error occurred. We cannot handle your request at this time."

What's going on: This error message can occur for a number of reasons, but most commonly if you're trying to import too much data at once. If importing more than 400 rows of data, try breaking up the data into two smaller imports. If the error persists, please reach out to Support. 

Spot-check

After you have completed an import, spot-check a few employees to ensure their entered information is correct.


Do you need to import opening balances?

For the opening balance template, enter the following data:

  1. Employee Name: I have added this column to the template for reference purposes only. I will choose not to import this column at the time data is entered through the importer.
  2. Employee #: The exact Employee # listed in BambooHR located on each employee's Personal Tab.*
  3. Opening Balance: (Number field) For a positive amount, the number should be entered as shown in lines 2, 3, and 5. For a negative amount (i.e., someone who has currently used more vacation time than they have), enter a negative number as shown in line 4.
  4. Time Off Category: The time off category that receives the amount listed in column C. The name of the type must match the name of the time off category within BambooHR.
  5. Effective Date: (Date field) The opening balance date. For example, If I were to add an opening balance for an employee as of May 1, 2022, and then put 5/1/2022 in column E. Please note that dates must be in a format with the four-digit year (mm/dd/yyyy). *If you use a different date format in your account, the import will automatically switch the dates to the correct format upon importing the spreadsheet.

After entering all of the appropriate data into the template, save the file as a .csv or .txt (Unicode Text) file.

*Note: An easy way to get the Employee Name and Employee # into the template is to copy and paste the information from a custom report in BambooHR.

Do you need to import balance adjustments?

For the balance adjustments template, enter the following data:

  1. Employee Name: I have added this column to the template for reference purposes only. This column will not import.
  2. Employee #: The Employee # listed in BambooHR.*
  3. Balance Adjustment:  You can add an amount of time by entering a positive number or subtract an amount of time by entering a negative number. Note that you do not enter the time unit label of days or hours in this cell.  The system already knows the appropriate information based on the type category.
  4. Time Off Category: The time off category that receives the amount listed in column C. The name of the category must match the name of the time off category within BambooHR.
  5. Comment: The note you want to appear with the balance adjustment.
  6. Effective Date: (Date field) The date that associates with a Balance Adjustment entry.  Please note that dates must be in a format with the four-digit year.

After entering all of the appropriate data into the template, save the file as a .csv  or .txt (Unicode Text) file. It is then ready for import. (See importing steps above.)

*Note: An easy way to get the Employee Name and Employee # into the template is to copy and paste the information from a custom report in BambooHR.

Do you need to import time off requests?

This template allows you to import a group of time off requests into the system all at once.

For the PTO Requests template, enter the following data:

  1. Employee Name: I have added this column to the template for reference purposes only. This column will not import.
  2. Employee #: The exact Employee # listed in BambooHR.*
  3. Date: The date of the time off request. If a request spans multiple days, you will need a separate line for each date in the request. Consecutive dates that span multiple rows in the spreadsheet will automatically group** as one request as long as they are of the same time off category. Note: Dates must be in a four-digit year format.
  4. Time Off Category: The time off category that the request will subtract from. The name of the category must match the category name within BambooHR.
  5. Amount Requested: The number of hours or days the employee will be taking off for the specific date(s) in the request. If the time off category tracks in days, the number cannot be greater than one. If the time off category tracks in hours, the number cannot be greater than 24. With this import, DO NOT enter a minus symbol in front of the time off request amount to indicate a negative amount ("-") because the system assumes that all values will deduct from the current existing balance. Do not enter days or hours in this field as the system automatically knows the time units based on the time off type category. (Note:  If you enter a minus symbol in front of an amount in the Amount Requested column, the system will add that time amount to the employee's balance.)
  6. Note: The note associated with the time off request. If a request spans multiple days, the notes will compile together into one note. So if you have a request that covers multiple days, it is best to only add your note to the first day in the request, and it will apply to the entire request.

After entering all of the appropriate data into the template, save the file as a .csv  or .txt file. It is then ready for import. (See importing steps above.)

*Note: An easy way to get the Employee Name and Employee # into the template is to copy and paste the information from a custom report in BambooHR.

** If one of the requests in a group of consecutively dated requests has an error when imported, the other requested days within the group will also show an error in the import. You will need to reimport the entirety of the request.

By importing, the system assumes that each time off request entered is already approved. All imported time off requests will automatically have an approved status, and the import will bypass the regular notification process.