Available for the following Payroll plans: Standard, Premium
The Imports feature allows you to efficiently import payroll configuration data in bulk using your own spreadsheet or a system-generated template. This feature is powered by a dynamic FlatFile import experience, designed to save time when setting up or updating payroll data, reducing the need for manual data entry.
Over the next few months, we will be adding more settings that you can import using this feature. This document will be updated progressively as new import options become available, ensuring you always have access to the latest capabilities.
What you can import
Custom Imports supports importing Pay Run Settings and Business Settings, including:
- Pay schedules
- Pay categories
- Benefit categories
- Expense categories
- HMRC and Pension details
Getting started with custom imports
Preparing your import file
The easiest way to ensure your import file is formatted correctly is to use a system-generated template:
- Navigate to Data Extracts via the link on the Custom Imports page.
- Export the Pay Run Settings or Business Settings template.
- Open the template file — it will include all required column headings for the setting you are importing for.
- Fill in your data under the appropriate headings.
- Save the file for import.
Helpful Hint
Using the system template ensures all column headings match the system fields, making the mapping process faster and reducing errors.
If you prefer to use your own spreadsheet, follow these formatting guidelines:
File format
- Supported formats: CSV, XLSX
- Ensure column headings are in the first row
Field naming best practices
Because many fields share the same name (e.g., "Name", "External ID"), it's best to prefix your column headings with their destination. This makes mapping much easier:
- Good: "Pay schedule name", "Business name", "Pension provider"
- Avoid: "Name", "ID" (these are too generic)
Yes/No and On/Off fields
For fields that are toggle switches or checkboxes in the system:
- Recommended: Use "true" or "false" — these will map automatically.
- Also accepted: "yes"/"no" or "on"/"off" — you'll need to map these manually.
Required vs optional fields
Not every field is mandatory. Only include the fields you need to populate. Validation will be triggered during import to check for required fields and correct formats.
Importing your data
Step 1: Upload your file
- After clicking Begin Import, you'll see the import interface powered by FlatFile.
- Click Upload file and select your prepared spreadsheet.
Alternative option
You can also manually enter data directly into the FlatFile interface if you do not have a file ready to upload.
Step 2: Map your fields
After uploading, you'll see the field mapping screen:
- Review the Incoming Fields (your column headings) on the left.
- Confirm they're mapped to the correct Destination Fields (system fields) on the right.
- Use the drag-and-drop feature to select which file columns map to the appropriate system fields.
- Click Continue when all fields are correctly mapped.
Important
Pay careful attention to fields with similar names. Ensure "Pay schedule name" maps to the intended field and not to another generic "name" field.
Step 3: Remap values (if needed)
If your spreadsheet uses different terminology than the system expects:
- Review any values flagged for remapping.
- Select the correct system value from the dropdown for each field.
- Click Continue when all values are correctly mapped.
Step 4: Review and validate
- Review all data in the preview screen.
- Scroll to check all columns for validation errors.
- Any invalid data will be highlighted in red.
- Click on any cell to edit and correct data directly in the preview.
- When all data is valid, click Submit.
Step 5: Confirm success
After submission:
- You'll receive a confirmation message that your data has been imported.
- Navigate to the relevant settings area to verify your imported data. You can import multiple categories sequentially without navigating away from the Imports section.
Further information
- Data Protection: All imported data is handled securely in compliance with GDPR.
- Storage: Uploaded files are not stored post-import unless required for auditing purposes.
- Versioning: The system will alert you if imported data conflicts with or overwrites existing settings.
Fields not mapping correctly
- Ensure your column headings are descriptive.
- Use the manual remapping screen to correct any destination field errors.
Data showing as invalid (red)
- Check that all required fields are populated.
- Verify that dates and numbers match standard system formats.
- Edit the invalid cell directly in the FlatFile preview screen to resolve the error before submitting.
Import affecting existing data
- If you're importing data that already exists in the system, you will receive a warning if data will overwrite current settings.
- Review any versioning alerts carefully before proceeding.