How to Change the Name of Your iXBRL File

While we automatically assign a name to your iXBRL package during the conversion package, you are free to change it. However, this isn't done by simply changing the name of the zip-folder as you have to ensure that the database and content uses the same name as “reference”. Therefore you need to update the name before you convert your files to iXBRL.

Before you start changing the name of your file, you need to be aware of the naming convention, a set of rules related to naming your iXBRL files, which are outlined below.

If you are already aware of the ruleset related to naming your iXBRL package, you can skip to the instructions on how to change the name.

The Rules for Naming an iXBRL Package

There is a set of rules related to naming your file. These are also known as a “naming convention”. The naming convention states the following conditions when naming your file:

  • Your file name needs to consist of two parts which are separated by a dash. The two parts are the “base name” and the “date”, written as "base name"-"date" and only in that order;
  • The “base name” can contain up to 20 characters, we recommend using your company's LEI code, which is also what we input as a standard;
  • The "base name" may only consist of standard characters from the modern English alphabet; 
  • The "base name" must be written in capital letters;
  • The “date” has to correspond with the end date of the reporting period, and it must be written in the format YYYY-MM-DD;

Following these rules, our example for a 2020 file could look like this:


Because many local OAM's (Officially Appointed Mechanisms) have added the requirement to end the filename with a language extension, we have added this as a default option.

This means that the default file name for a file in English will look like this:



How to Change the Name of Your iXBRL

Changing the name of your iXBRL package is done by editing the name stated in the general data sheet in the Excel template you use for converting your files to iXBRL. So, the first thing you need to do is open your Excel template and then proceed with the following steps:

  1. When you have opened your Excel template, you need to go to the general data sheet and find the row labeled "Customer taxonomy file name";esef-taxonomy-file-name
  2. Before changing the name, you need to be aware that the cell is currently occupied by an Excel formula which automatically updates the name whenever you update your reporting period. Said formula looks like this; 
  3. In the code above you need to exchange "&PP_IdentificationOfReportingEntity&" with the name you want to give your file, while keeping in mind the rules set forth in the naming convention. Following these guidelines, if Tesla wanted to change the name of their file from the LEI code to TESLA their code should look like this after making changes;
  4. It is also possible to simply write the name and date in the cell, but doing so, means you will need to update the name manually every time you update your reporting period, which is why we recommend the approach outlined in step 2 and 3; 
  5. After you have updated the name and saved the Excel template, we urge you to do a test conversion with the changes and upload the resulting iXBRL package with the changed name to the ParsePort XBRL Inspector. That way you will know that everything has been changed according to your desires.

If you experience any issues with the process described here, send a description of your issue along with your changed Excel template to and a member of our support team will help you get sorted.