> ## Documentation Index
> Fetch the complete documentation index at: https://help.findity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Import dimensions on users

<Note>
  **This article applies to the following countries**

  * All countries
</Note>

If your organisation uses dimensions with preset values on user level, you can set the dimension values when you add/import users. Let’s take a look at a few possible scenarios.

<Tabs>
  <Tab title="Scenario 1: New organisation without users">
    Here’s a newly created organisation that has no users yet. Perhaps not a common scenario, but let’s start with it anyway.

    Our organisation, dimensions and users.

    <Frame>
      <img src="https://mintcdn.com/findityab/pAqGlVGGdlx1nQLZ/images/en/import-dimensions-on-users/01.png?fit=max&auto=format&n=pAqGlVGGdlx1nQLZ&q=85&s=e37d923972722b1f682980106a00bb70" alt="" width="1198" height="380" data-path="images/en/import-dimensions-on-users/01.png" />
    </Frame>

    **Prepare the dimensions:**

    You can import dimension values, but only to existing dimensions. So:

    * The organisation has to have dimensions in order for dimension values to be imported.

    * The dimension must use preset values on user level.

    * For list and searchable dimensions, all valid values must be defined in the organisation.

    Let’s start! In this example, we use three dimensions.

    <Frame>
      <img src="https://mintcdn.com/findityab/pAqGlVGGdlx1nQLZ/images/en/import-dimensions-on-users/02.png?fit=max&auto=format&n=pAqGlVGGdlx1nQLZ&q=85&s=fd3a2f728ff755c1ba53032740cfb530" alt="" width="1392" height="682" data-path="images/en/import-dimensions-on-users/02.png" />
    </Frame>

    Add all allowed values for the list and searchable-list dimensions.

    <Frame>
      <img src="https://mintcdn.com/findityab/pAqGlVGGdlx1nQLZ/images/en/import-dimensions-on-users/03.png?fit=max&auto=format&n=pAqGlVGGdlx1nQLZ&q=85&s=13e477084d9a6b528005ba38ded39d57" alt="" width="2274" height="764" data-path="images/en/import-dimensions-on-users/03.png" />
    </Frame>

    Only existing dimension values can be imported for list dimensions.

    The freetext dimensions do ot need to have predefined values.

    **Export the user list:**

    To get a template file that you can fill with users, you should first export the organisation’s user list (even if there are no users yet.

    Go to *Users*.

    <Frame>
      <img src="https://mintcdn.com/findityab/pAqGlVGGdlx1nQLZ/images/en/import-dimensions-on-users/04.png?fit=max&auto=format&n=pAqGlVGGdlx1nQLZ&q=85&s=3d8ddf3acca71bc799386f6bb5c52453" alt="" width="2650" height="874" data-path="images/en/import-dimensions-on-users/04.png" />
    </Frame>

    Ready for user list export. Note that the dimension columns have been added to the view.

    Click *Export Users*.

    <Frame>
      <img src="https://mintcdn.com/findityab/pAqGlVGGdlx1nQLZ/images/en/import-dimensions-on-users/05.png?fit=max&auto=format&n=pAqGlVGGdlx1nQLZ&q=85&s=3952cde2e92866aaee659e5e9b1e36e8" alt="" width="2564" height="640" data-path="images/en/import-dimensions-on-users/05.png" />
    </Frame>

    An export file is generated, with placeholders for the dimensions (Swedish columns since the organisation is Swedish).

    **Prepare the import file**

    Fill the exported file with users and their preset dimension values. Some rules:

    * Each user must have a valid email address
    * The list and searchable-list dimension values should exist in the organisation
    * Empty dimension values are allowed
    * Remember to save the file before importing it

    <Frame>
      <img src="https://mintcdn.com/findityab/pAqGlVGGdlx1nQLZ/images/en/import-dimensions-on-users/06.png?fit=max&auto=format&n=pAqGlVGGdlx1nQLZ&q=85&s=2fe2ea73379247ad817e9c5c4561f221" alt="" width="2700" height="812" data-path="images/en/import-dimensions-on-users/06.png" />
    </Frame>

    **Import users and dimensions**

    ClickAdd users in the user view. Then clickImport from Excel.

    <Frame>
      <img src="https://mintcdn.com/findityab/pAqGlVGGdlx1nQLZ/images/en/import-dimensions-on-users/07.png?fit=max&auto=format&n=pAqGlVGGdlx1nQLZ&q=85&s=3cdd44646ff7582c569f3d1ebff674c9" alt="" width="2694" height="712" data-path="images/en/import-dimensions-on-users/07.png" />
    </Frame>

    Click *Import*. A file selection dialog opens. Select the file you prepared and click *Open*.

    <Frame>
      <img src="https://mintcdn.com/findityab/pAqGlVGGdlx1nQLZ/images/en/import-dimensions-on-users/08.png?fit=max&auto=format&n=pAqGlVGGdlx1nQLZ&q=85&s=abbf0b055d2a5a7aab406e6c01c0d1ff" alt="" width="2310" height="994" data-path="images/en/import-dimensions-on-users/08.png" />
    </Frame>

    If the import was successful, you will see the list of new users.

    <Frame>
      <img src="https://mintcdn.com/findityab/pAqGlVGGdlx1nQLZ/images/en/import-dimensions-on-users/09.png?fit=max&auto=format&n=pAqGlVGGdlx1nQLZ&q=85&s=18ee718d75bf3ecaefeddbc61ed6d14a" alt="" width="1550" height="894" data-path="images/en/import-dimensions-on-users/09.png" />
    </Frame>

    Click *Save* to add the users to the organisation.

    <Frame>
      <img src="https://mintcdn.com/findityab/pAqGlVGGdlx1nQLZ/images/en/import-dimensions-on-users/10.png?fit=max&auto=format&n=pAqGlVGGdlx1nQLZ&q=85&s=4b07bfd3708a90c967e5b843dd43431d" alt="" width="2338" height="1294" data-path="images/en/import-dimensions-on-users/10.png" />
    </Frame>

    *Users and their dimension values imported to the organisation.*
  </Tab>

  <Tab title="Scenario 2: Org with users, missing dimension values">
    The “new org without users” scenario is probably not usual. Normally, the organisation already has users, but perhaps you want to set the dimension values for them. Not a problem, just follow these steps.

    <Frame>
      <img src="https://mintcdn.com/findityab/pAqGlVGGdlx1nQLZ/images/en/import-dimensions-on-users/11.png?fit=max&auto=format&n=pAqGlVGGdlx1nQLZ&q=85&s=93ccfdc1e429326a75d137a0e811f837" alt="" width="2320" height="1280" data-path="images/en/import-dimensions-on-users/11.png" />
    </Frame>

    *We want to add a dimension value here.*

    **Export the user list:**

    Always start by exporting the current list of users. See instructions in tab “New organisation without users”.

    **Add the missing dimension values:**

    Open the exported file, find the user you want to update, and add the dimension values.

    <Frame>
      <img src="https://mintcdn.com/findityab/pAqGlVGGdlx1nQLZ/images/en/import-dimensions-on-users/12.png?fit=max&auto=format&n=pAqGlVGGdlx1nQLZ&q=85&s=6bef19e837d90da3a4f20463597b06ed" alt="" width="2368" height="368" data-path="images/en/import-dimensions-on-users/12.png" />
    </Frame>

    *Adding the dimension value.*

    Save the file.

    **Import users and dimensions:**

    Import the user list as described above. Existing data will be preserved; new data will be added.

    <Frame>
      <img src="https://mintcdn.com/findityab/pAqGlVGGdlx1nQLZ/images/en/import-dimensions-on-users/13.png?fit=max&auto=format&n=pAqGlVGGdlx1nQLZ&q=85&s=82640cc2c06d84de2b8c5fe6059432d0" alt="" width="2370" height="1230" data-path="images/en/import-dimensions-on-users/13.png" />
    </Frame>

    *Updated user.*
  </Tab>

  <Tab title="Scenario 3: Replacing dimension values">
    Let’s say you need to reassign all staff to a new project, Project D. By re-importing the list of users and dimensions, you can quickly assign the correct dimension values.

    **Prepare the dimension values:**

    Add or modify the dimension values in the organisation as necessary.

    <Frame>
      <img src="https://mintcdn.com/findityab/pAqGlVGGdlx1nQLZ/images/en/import-dimensions-on-users/14.png?fit=max&auto=format&n=pAqGlVGGdlx1nQLZ&q=85&s=d25c8d0372ec35eeb6a5c9d4a05c135b" alt="" width="1428" height="1108" data-path="images/en/import-dimensions-on-users/14.png" />
    </Frame>

    *A new dimension value.*

    **Export the user list:**

    Always export a current list of users before importing.

    **Modify the dimension values:**

    Update the exported file to reflect the new dimension values.

    <Frame>
      <img src="https://mintcdn.com/findityab/pAqGlVGGdlx1nQLZ/images/en/import-dimensions-on-users/15.png?fit=max&auto=format&n=pAqGlVGGdlx1nQLZ&q=85&s=184582e2e914e228421f2314588f5ebc" alt="" width="2764" height="436" data-path="images/en/import-dimensions-on-users/15.png" />
    </Frame>

    *Updated file.*

    **Import users and dimensions:**

    Import the user list as described above. Existing data will be updated; new data will be added.

    <Frame>
      <img src="https://mintcdn.com/findityab/pAqGlVGGdlx1nQLZ/images/en/import-dimensions-on-users/16.png?fit=max&auto=format&n=pAqGlVGGdlx1nQLZ&q=85&s=d3e628536c062fff5c2f31218d999bd9" alt="" width="2762" height="1184" data-path="images/en/import-dimensions-on-users/16.png" />
    </Frame>

    *Updated users.*

    **Error handling:**

    The import process is designed to handle common issues and has error handling to resolve them.

    - If two or more dimension names are identical, the import is cancelled. Since we match imported dimension names to the organisation’s dimensions, the names must be unique.
    - If unknown dimension names are found during import, the import continues but the unknown dimensions are ignored. In other words, you cannot add dimensions to the organisation by importing them.
    - If unknown dimension values are found during import, the import continues but the unknown values are ignored. In other words, you cannot add dimension values to existing dimensions by importing them.

    Note: Blank dimension values are ignored. That means you cannot “delete” an existing dimension value for a user by importing a blank value.
  </Tab>
</Tabs>

## Related articles

* [How do I add one-day assignments for per diem?](/en/settings-administrator/how-do-i-add-one-day-assignments-for-per-diem)
* [We want to have approval according to cost centers or department structure that is preset on the user. How do we do this set up step by step?](/en/settings-administrator/we-want-to-have-approval-according-to-cost-centers-or-department-structure-that-is-preset-on-the-user-how-do-we-do-this-set-up-step-by-step)
* [How do I make changes in the organisation structure?](/en/settings-administrator/how-do-i-make-changes-in-the-organisation-structure)
* [What settings do we need to update on organisation level prior to a new year?](/en/other/what-settings-do-we-need-to-update-on-organisation-level-prior-to-a-new-year)
