You can create or update assets in bulk by importing a CSV file. Here are some general guidelines on importing the assets. 


Preparing for first time Asset Import

  • If you need to create custom Asset Types, then create them before you begin the import. (You can create new asset types by going to Admin -> Asset Types)
  • If you need to create custom asset fields for each asset type, then create them before you begin the import
  • If you have created new fields such as Drop Down fields which can have choices, ensure that you add the choices under Admin -> Asset Types before import


Preparing your CSV file for upload

  • Split your CSV file by Asset Type - You can only import assets of one asset type in one go. As a first step, create a separate file for each asset type.
  • Required columns
    • By default, the Display Name is the only field required for an asset by Freshservice. Ensure that your CSV has this column
    • If you have configured any fields as required, ensure that these are also available in your CSV
    • Attached is a sample CSV file for Laptop Asset Type (Tip: You can get a template for any asset type by creating a sample asset in Freshservice and exporting it. Make sure you select All Fields when exporting the file to get all the possible fields for that asset type)
  • To assign an user to an asset, specify the email id of the user in the Used By field. 
  • To assign an agent to an asset as Managed By, specify the email id of the agent in the Managed By field


Importing the File


  • Go to Inventory ->  Import
  • Select the Asset Type you want to import
  • Upload the CSV file 
  • Choose how to Match Records in the CSV with assets in Freshservice. 
    • If the Asset Type selected for Import Hardware or it's child types, you can match records by Serial Number (Default), Display Name or Asset Tag.
    • If any other asset type is selected, you can choose to not match records at all (Default - This will create all the entries in the CSV as new assets) or match records by Display Name or Asset Tag
  • Click Next


Mapping Fields

  • Freshservice automatically maps the fields in your CSV based on the header in the CSV. The values of the first asset entry in the CSV file are also shown as an example next to the mapping
  • You can review this mapping and make any changes as needed
  • Ensure the date format selected and the date format in the CSV matches if you wish to update any date fields
  • Click Import to start the import process

Import Result and Common Errors

  • The import status screen shows the current status of the import. The status is updated every 30 seconds
  • Once the import is complete, you will get a import status and a quick summary of errors encountered during the import
  • An email with import status report will also be sent to the user who initiated the report once the import is completed


Asset Import Sample (Laptops).csv Asset Import Sample (Laptops).csv

(699 Bytes)