Skip to content
  • There are no suggestions because the search field is empty.

Import Employees and Employee Records (Admin)

Last Updated: 6 November 2026

What you can see and do here depends on the permission group (role) your admin has given you. See Set Up Roles and Permission Groups.

What It Is and Who It Is For

Import lets you add or update many employees at once from a spreadsheet, and bring in their history, documents and photos. It's the fastest way to move from another HR system or spreadsheets into Plumm.

This article is for Super Admins and admins whose permission group includes Import.

Prerequisites

Set these up first, in this order, so imported people link to them:

  1. Company details. See Set Up Company Details and Branding (Admin).
  2. Working schedules and holiday calendars.
  3. Locations. See Add Company Locations (Admin).
  4. Value lists such as departments. See Configure General Settings, Custom Fields and the AI Agent (Admin).
  5. For leave history: time off policies. See Set Up Time Off Policy Types and Policies (Admin).

Permissions by Role

Role What They Can Do
Super Admin All imports
Admin All imports, if their permission group includes Import. Narrower admin roles may get Access Denied on the Import tab
Manager No access
User (employee) No access

What You Can Import

Go to Admin > Settings > Import. Pick what to import from the Import Profile Section drop-down:

Option What It Does File
Add Staff Detail Creates new employees Excel template
Update Staff Details Changes details of existing employees, such as department or phone number Excel template
Manager Detail Sets who reports to whom. Updates the current profile and the org chart Excel template
Import Contract History Adds past contracts Excel template
Import Role History Adds past job roles Excel template
Import Emergency Contact Adds emergency contacts Excel template
Import EEO Adds equal opportunity details Excel template
Import Training Adds training records Excel template
Import Device Adds company assets given to people (when you don't use the Tech add-on) Excel template
Import Time Off Adds past or booked leave Excel template
Import Profile Picture Adds profile photos ZIP of images, up to 1,000
Import Document Adds documents to employee folders ZIP, under 100 MB

Import in this order: Add Staff Detail first, then Manager Detail, then history, leave, documents and photos.

Admin: Import From an Excel Template

These steps work for every Excel import.

  1. Go to Admin > Settings > Import.
  2. Choose the option from Import Profile Section, then click Next.
  3. Click Download Template. For new staff the file is Plumm_Add_Staff_Details.xlsx.
  4. Fill in the template:
    • Use each person's work email as the identifier. For Add Staff Detail the emails must be new. For every other import they must match existing employees.
    • Fill every required column. Leave optional columns blank rather than typing "TBC" or "N/A".
    • Don't rename the sheet tab or change column headers, or the file is rejected.
    • For history imports, give each entry for one person a different effective date.
  5. Back in Plumm, choose the Select Date Format that matches your file (for example dd/mm/yyyy).
  6. Click Upload and pick your file. Up to 1,000 rows per file.
  7. Click Next. Check the column mapping. If a column isn't matched, pick the right Plumm field from the drop-down.
  8. Review the errors and warnings. Click Download Errors File to see every failed row and why.
  9. Fix the file and upload it again, or tick Skip Row for rows you want to leave out.
  10. Click Submit (or Import). Only valid rows are imported.
  11. Open a few of the imported profiles to check the data.

Admin: Import Documents or Profile Pictures From a ZIP

  1. Go to Admin > Settings > Import and choose Import Document or Import Profile Picture.
  2. Click Upload and pick your ZIP file, then click Next.
  3. Set the mapping:
    • Uploading Folder (documents only): the folder in Plumm the documents go into.
    • Mapping Documents: File Name if each file is named after the person, or Folder Name if files sit in a folder named after the person.
    • Match Type: Exact (recommended) or Contains. Use Contains with email only, not employee ID.
    • Identifier: Email ID or Employee ID.
  4. Click Next. Problems show in Error Description. Click the link (or Download Error File) for the full list, or tick Skip for single rows.
  5. Click Submit. Large ZIP files can take a while at the last step. Wait for it to finish.

Settings

Option Notes
Import Profile Section Which import to run
Select Date Format Must match the dates in your file. Five formats to choose from
Rows per file Up to 1,000. Split bigger files
Document ZIP ZIP only, under 100 MB
Picture ZIP Up to 1,000 images

Limitations

  • History imports (contracts and roles) are saved as history. They don't change anyone's current active contract or role.
  • Import Time Off refuses a second leave record for the same person on the same day: This user already has an existing leave record for the same day.
  • Import Device is for companies without the Tech add-on.
  • Imports can't be undone in one step. Fix wrong data with Update Staff Details or on the profile.

Best Practice

  • Test with 5 to 10 people first, including a part-timer, a manager, a leaver and someone with leave history.
  • Keep your source file.
  • After each import, check that the number of people in My People matches the rows you imported.
  • Make sure every employee except the most senior person has a manager, and nobody reports to themselves in a loop.

FAQs and Troubleshooting

Why Was My File Rejected? The sheet tab or column headers were changed, the date format doesn't match Select Date Format, or required fields are empty. Download the errors file to see each reason.

Some Rows Failed. Do I Need to Import Everything Again? No. Valid rows are imported. Fix only the failed rows and import them in a new file.

I See "Some Employees Might Not Have Access to the Selected Folder." One or more people you're importing documents for can't access the folder you chose. Check the folder's access in Admin > Settings > Documents.

Can I Import More Than 1,000 Rows? Split them into several files of up to 1,000 rows each.

Does Importing Managers Update the Org Chart? Yes. Manager Detail updates the current Reports To and the org chart.

Related Articles

  • Add Employees (Admin)
  • Documents: Company Folders and Employee Documents
  • Employee Profile: Job, Contracts, Working Schedule and FTE (Admin and Manager)