Onit Documentation

CSV Import Formatting Requirements

by Sigmarie Soto Updated on

This article covers general CSV requirements and other information to help you prepare your file for creating or updating records in bulk using the import option. The CSV import option is recommended if you need to do any of the following:

  1. Create multiple new matters associated with the same matter template
  2. Create multiple new vendors
  3. Create multiple new cost codes
  4. Update multiple matters to reflect different values for supported system fields (e.g., general attributes, custom attributes, assigned vendors, or assigned invoice reviewers)
  5. Update general/custom attributes, settings, or invoice reviewers for multiple vendors
  6. Update general fields for multiple cost codes (e.g., Name, Description, etc.)

TIP: For existing matters, use the Bulk Editor instead if you are making the same value change for specific attributes or other supported fields, such as updating the status from open to closed for 100 matters. The Bulk Editor can only be used for updates to existing matters.

Creating New Records

New records in a CSV import file must have minimum required fields. Review the table below for general information about supported field and data types for new records.

New matters in a CSV import file must all be associated with the same matter template. A separate import is required if you need to create new matters associated with a different matter template.

Review the table below for general information about supported field types for new matters.

NOTE: A maximum of 1,000 new records can be created per CSV import. If additional records need to be created, you must create and import a separate CSV file.

Field TypeDescription/Notes
SINGLE-SELECT FIELDS

This applies primarily to list-type column headers for General Attributes or Custom Attributes that either: 1) have lists of values in the system, or 2) only accept one of two values (i.e., YES/NO, ON/OFF, ACTIVE/INACTIVE). 

For lists of values, the values are case-sensitive and must match the formatting, spacing, and spelling that appears in the system. 

Examples of list-type attributes for new matters:

  • Legal Entity

  • Matter Group

  • Matter Status (i.e., Draft, Open, or Closed)

  • Matter Lead (i.e., valid/existing/active email address)

Examples of list-type attributes for new vendors:

  • Status (i.e., ACTIVE or INACTIVE)

  • Default Cost Code

  • Default Matter Group

  • Default Template

  • Accruals (i.e., ON or OFF)

Examples of list-type attributes for new cost codes:

  • Status (i.e., ACTIVE or INACTIVE)

Custom attributes depend on settings in your environment.  

MULTI-SELECT FIELDS

This applies to column headers for the following:

  • Invoice Approvers Level 1 (All of): Requires email address(es) of valid/active/existing Unity user(s) or User Team names when creating new matters or vendors.

  • Invoice Approvers Level 2 (All of): Requires email address(es) of valid/active/existing Unity user(s) or User Team names when creating new matters or vendors.

  • Vendors: Requires the system-generated Vendor ID(s) to assign vendors when creating new matters.

If entering more than one value for any of the above, they must be separated by semicolons (;) for successful processing. 

Examples of values for Invoice Approvers:

Single reviewer (one email address):

[email protected]

Two reviewers (two email addresses):

[email protected]; [email protected]

If assigning one or more vendors to a new matter, you must enter the system-generated Vendor ID(s). For more details about assigning Invoice Approvers and Vendors while creating new matters in bulk, click here.

DATE FIELDS

This applies to column headers for General Attributes and Custom Attributes that accept dates in the following format:

YYYY-MM-DD

Examples of date-based general attributes include:

  • Open Date

  • Closed Date

NOTE: Date fields do not apply when creating new vendors or creating new cost codes. 

TEXT FIELDS

This applies to column headers for General Attributes and Custom Attributes that accept text strings.

Examples of text-based general attributes for matters include:

  • Matter Name

  • Matter Description

Examples of text-based general attributes for vendors include:

  • Name

  • Contact Name

  • Address

  • City

  • State

  • Additional

Examples of text-based general attributes for cost codes include:

  • Name

  • Description

  • Accounting Code

NUMERIC/CURRENCY FIELDSThis applies to column headers for General Attributes and Custom Attributes that accept numerical values only (i.e., no commas, decimals, or other symbols). 

Updating Existing Records

The following three actions are supported for bulk updating records in bulk: Add, Replace, and Remove. Please review the information below carefully to avoid unintentionally overwriting or erasing data. 

NOTE: A maximum of 10,000 existing records can be updated per CSV import. If additional records need to be updated, you must prepare and import a separate CSV file. 

Bulk ActionDescription/Notes
ADD

To add a value to existing values in a record, you must include the existing values along with the new values in your file. This applies to system fields such as Subscribers, Vendors, and Approvers.

For example, to add a subscriber to a matter but keep existing assigned subscribers, you must include the email address of the new subscriber along with the email addresses of the existing subscribers (separated by semicolons).

Importing a CSV file with only the new value is equivalent to replacing the existing values. This means all existing subscribers will be overwritten and only the new subscriber in your CSV file will be assigned to the matter. 

The values you add to the CSV file will be the final values saved to the matter,

REPLACE

Values entered for system fields in a CSV file will overwrite the existing values saved to the record. 

For example, to replace all vendors assigned to a matter with one new vendor, enter only the ID of the new vendor. Including only the ID of the new vendor means that any existing assigned vendors will be erased from the matter. 

This can also be used, for example, if you need to replace inactive approvers across multiple matters OR multiple vendors. 

REMOVE

To erase one or more values currently saved to a record, enter none as the value for that column header / matter in the CSV file.

For example, if you want to erase the description for an existing cost code, you can enter none under the Description column for a specific row.  

A blank cell in a CSV file will not erase the value(s) currently saved to a matter record. No action will be taken for blank cells upon import.*

*This does not apply to CSV imports for Matters with Allocations. A blank cell in a CSV file for Matters with Allocations is equivalent to entering none and will erase any values currently saved to the allocated field for that matter record. For additional details on CSV formatting for Matters with Allocations, click here.

NOTE: If you are unsure whether values need to be added, replaced, or removed, we recommend confirming the information for specific records before uploading an import. 

Supported Fields & Additional Information

General CSV Formatting Requirements & Notes

The below applies to ALL CSV files for bulk updating and creating records:

  • The CSV file should have a row per record; add values for records starting on Row 2 (i.e., Row 1 is designated for supported column headers). 

  • Values entered for list-type fields, such as Legal Entity and Matter Group, must exactly match the list value as it appears in Unity (e.g., formatting, spelling, etc.). 

  • If including more than one value for multi-select fields, make sure to separate each value with a semicolon. This applies to fields such as Invoice Reviewers and Vendors. 

  • If the CSV file has column headers for custom attributes in matters, the custom attributes must all be associated with the same matter template. This applies to creating new matters and bulk updates for Matters with Custom Attributes and Matters with Matter Template Updates

  • Some column headers or field names described in our resource center may differ from those shown in your environment depending on custom labels and other settings (e.g., Matter Group may appear as Practice Area or Cost Code may appear as Charge Numbers). 

  • Using our CSV templates is not required but recommended to help you determine which fields are supported and avoid having to start from scratch. If preparing your own file, you will be prompted to map column headers in your file to system fields to continue with import. 

The below applies to CSV files for bulk updates only:

  • The first column (i.e., Column A) in CSV files must be for record ID and is required for all imports regardless of the bulk update type. Specifically:

    • Client Matter ID for bulk updates to existing matters

    • Vendor ID for bulk updates to existing vendors

    • Cost Code ID for bulk updates to existing cost codes

    • List Value ID for bulk updates to existing custom attribute list values

    • Legal Entity ID for bulk updates to existing legal entities

    • Matter Group ID for bulk updates to existing matter groups

  • At a minimum, the CSV file must have an ID column header and at least one additional column header to move forward with upload and import. 

  • CSV files for Matters with Approvers and Vendors with Approvers are handled differently due to the Any ofAll of invoice reviewer structure built into Unity.

  • Bulk updates to invoice reviewers in supported record types are handled differently due to the reviewer structure built into Unity. You must select the [Record] with Approvers option to add, update, or remove invoice reviewers at the record level (i.e., Matters with Approvers, Legal Entities with Approvers, Matter Groups with Approvers, or Vendors with Approvers). 

  • Only the Matters with Matter Template Updates option allows for bulk updates to closed matters. In this case, the matters are temporarily re-opened for processing only and then automatically reverted to closed upon completion. No additional action is required. 

  • If other types of bulk updates are required for closed matters, they must first be re-opened manually or by using the Matters with General Attributes option to change the status from closed to open. 

Previous Article Using the CSV Import Option
Next Article Invoice Validation Rules

© 2025 Onit, Inc.

docs.onit.com contains proprietary and confidential information owned by Onit, Inc. that is subject to copyright. Onit presents it exclusively to you for your sole use in conjunction with using Onit products. No portion of the materials contained herein may be used for any other purpose. No portion of the materials contained herein may be shared with third parties or reproduced in any form.