Uspacy Knowledge Base
All materialsSettingsImport

Import of employees from a file

Import of employees from a file

Here we will tell you how to upload the file for importing employees, map the fields to the fields at Uspacy and how to start the import

You can also use Import from file to add new employees to the Space. As a result, user data will be transferred to the system and will be displayed in their profiles. In addition, employees will be imported into the company structure, to the department in which they work.

πŸ’‘ Only an administrator or superadministrator of Space can do this.

Uploading a file

To start the import, go to the Employees page, click the gear and select Import from file.

9nOqyXn9Oz7KNnH4h0_HOB1IQQQM8XP4lfVDTPkXo0duGrKjf5oE5VKz1AN_cWhdg1WGB1UetYhQwVDMy3fHwPGGObyBCGBcXdKScicYaO2_DTGN-0skIeAvuY16Vr_1yo4fSS6H1QFgZkhu6VtYQj4

Next, upload the file from your personal computer.

❗️The file for import must be in *CSV format in UTF-8 encoding. In Excel, this is named: CSV UTF-8 (comma-delimited) (*csv).

The columns in it will be mapped to the fields at Uspacy. And each row of the file is data about a separate employee.

qnFE6VObmlvt0zTKfSaNjBu0nj6gT8n3-vNxKM55f7auQ5aZQbsewPNHm9umNp-nDalhDYlZgD5N0EWGP8F10OlU0M_K85Sko_ymK2nTUiqNZK0G3oFuAuNiPCJbOcV3kuwHTVrfKx6B9d1leUmKnro

Pay attention to the import recommendations.

IMScD2WW_Mu5Ra9KZfzGXHW1XFBKpWvI4tiT-pzNxGfbQW-Kkt89RM84FGR-2PnmKIS51UqCtLQyGO7H852LlN28i7bZ-c_4NXzL6i19GNZEaSV6t0R2qZY7jGZc1bpZzmML0k62KxMK9zEn2cw0CD8

You can also use a template.

πŸ” If you have difficulties with the correct display of the template in Excel, we advise you to read our article, where we told how to fix it.

BdayRGi8ylTvKlcVRPZdWw592u3Y84jHFQoWYC5uLnU8iYEbU4zT-vrVatjevWtDY_I4OszomxDT4zR8vo-KkQFW8enUk04ZiiMDf1CijegtwQXThOGYnF8EooYsX5G-w1m0e4LLEJF_4YvSc5_j-n8

Preview and fields mapping

The settings and preview page will open. Here you can configure import parameters and map fields from the file to the fields at Uspacy.

First pay attention to: Encoding, Delimiter and Field mapping type.

πŸ’‘ Advice

6azUEyrd8YugxBjfeCRrKjHIr_JfgzjHQV2PvyF9Q6f-bGph4CPzOLyM4r8-EbScgZBBylSC0o1mqz8ejNUozFnI0IAVuWZ6V2ecPW9ZqctYyh7znG_6uD5vFAtUCZbEf3tL_o6UUpgr7-IlO4q1d6M

Next, select whether the first row will contain headers. If you uncheck the box, it will look like the screenshot below.

☝🏻If the first row of the file does not contain headers, then it will be imported. An element (employee) will be created as a result of the import.

MNSTTY7ccAatYkZt-QnuBeviqnvA6upzbXrUSvOQDwMpF9Ibu8HU7ZQg06CMaZuHZCTFfkbG3x5rHfumXO3HXElzQzMSpO3XX8WBsx-oe9HfbvXGUwWzreR9PGaoLwuZWILKnfaNkqGaVLz2azs4kIg

And if you leave a check mark, the headers will be highlighted. The first row of the file will not be involved in import.

hmKy6gDPl83qB28n9OmS_d72DbQfczuHVXvaV_KAqW-y-z6pm5wXwBZLqDnvrF3ztv5cjHvuCBj1sdnGvDUANyEI8kBQIlfFUHNg7YXF6IPiJpe72jneJCc54yTgdN4PJnIEWMsoFm6FS3smkKeSTo4

Also specify whether to skip empty columns. If you uncheck the box, then on the preview page you will see an empty column that is in your file.

ODpArPdcuX5INEZaTHJGBUiT3FClZjiVdaiE_rPtenSO_1lkp3suR6WmVcFb5GcRtaR3jOVz7XOctGpfgbS2WmaOwI_3NQWyZ9ov1lPzeRso8U8HuSjzBjGhYqubQHCmUTGUQbBADYemjeLvGZgjFww

If you leave a check mark, the column will not be displayed.

pxO2Ad6XZYaYC4CjMY0nmI3_uJREG0aByTedJmOlm5VmO0KRQb_U5sMCsu7IRryZNUSDMuzPQTY8JtrpPxLE15dmTF3lt6n6oM0XpcD2jVb_Y0C_RRlbJDFgICaP7BnET4eMvDQbgAdhYfzpJazPSO0

β—οΈβ˜πŸ»But note that if the option is active but you still see an empty column, it means that there is no data in the rows that are available for preview. But in general, the file in this column has filled rows, but they did not get into the preview mode.

You can return to the previous settings at any time using the reset button.

uR_BMzrrABPSmp6LowFn_Ze3TfjglInhGvS_GBCWVh2OyH_YiCMsx0-0FUGroSWIhTzBR43isOkAe9GyjRA3tkU9AnKOHgkdJwRImllrkMQE4vKp5mGibK8fzmkYKmOjYQHc3sgkvH2N70WBRUNBgwo

For a successful import, you need to map the fields from the file to the fields at Uspacy. The system does this automatically. But it maps some fields according to the required values at once.

uwb1XB3jUxRQa_Ls3TRrCXEAe-zxsuwNoVtpMXPGdL9j7IzDIXFsE3iu7xPzfzcSuCxJjaQjJVnDznW2utYIGrVE77YZgqdtbLKpbCFlszefjDXZYVZN3CZVw_WWnt7PCtZkmrsx345DRA_Hg_jW2cc

And others - to the value Do not import. For them, you need to manually specify the fields into which the information from the rows of the file will be transferred.

fxdooeZAn6dWblbaESmSLntMphTOUFwYh16lxpSBA-TKNsxroLjq8CQTlPvqvcM9e0WPa0O9ApMuPrrZLm9JNYJKOrJ6oiheRL0P-Cuoyxjdimm4KSU7r52sxWLvUc8X1m5t4o73WsKqEJHDufIrtZ8

❗️If you leave the value Do not import, then the data from this column will not be transferred at all.

πŸ’‘ Note: The examples show the types of fields and data formats as they appear in the system after import. They are NOT samples of how your data should look in the file.

Monosnap+Uspacy+β€”+Ρ”Π΄ΠΈΠ½ΠΈΠΉ+Ρ€ΠΎΠ±ΠΎΡ‡ΠΈΠΉ+простір+для+ΠΎΡ€Π³Π°Π½Ρ–Π·Π°Ρ†Ρ–Ρ—+Ρ‰ΠΎΠ΄Π΅Π½Π½ΠΈΡ…+процСсів+ΠΊΠΎΠΌΠΏΠ°Π½Ρ–Ρ—+2025-07-10+16-39-21.png

At any time before the import starts, you can delete all mappings by clicking on the special button.

YXkZbyMMfTSI9NMBm48O0cqwYQlvkPO3Jx39ZUoUfXVzjt6TvUAr7_8EvDT-kIMAMOrUEkJ3zjm9c8q874VFTKTUBT-kxiC7IajNzB3AXbpeNcVYH9A6fdBZW1atdDftrZeJ1Wlhp6v-4VLefjQg7wk

But you must confirm your actions. The system will also inform you that all fields will need to be mapped manually after the reset. That is, you will not be able to return to the previous settings, as well as to start the import.

uHXZbBkug7J9gP1L-tZqQ4HXVMLJfu-OEisnqGCubt0aBJ9q5lgXh6thbbseVqxpAsHZXAg7vXyeZmEZSZWwj6xfToz2KlnZsXYSM5KxLUZD8MemytdCQm3ofxs7K6RJcRmtijZllp_yC5B4bk18t2A

As a result of the reset, all columns from the file will be transferred to the Unmapped fields section. Fields that could not be mapped for technical reasons may also be displayed here.

LT0z2Ai75HJL22GaFa34QILZgk1s_pIfRADOXBFqcH-5fJbRxJdfjnrzjf5uvlwt-fWMPqv4xnSEKzx3nTkYp8dXrA_1FTVU76NNCl2xcjzluvwctbyuQ-D7sZJBzroZ3JMwuTU8oTgIhsDipnVTanM

Peculiarities of fields mapping

To correctly import employees and proceed to the next step, you must have the Email address:Main column in the file and map it to a similar field at Uspacy.

7GoTKbOYJpWCuM37mUV8DCNjqSZhB2VG8KJ_CW-plPuqQTotB_tQ4EcGPUScD7wiDAfUA45O-61y9yrZJ3E40kSalfJ9k6_jrL8ffoQ9Dg3qsOXBTBPa_sjpJL-EZosi1mqWFMkilVQ75n4IBTUfVCg

β˜πŸ»β—οΈThis email will be used for further user login to the Space. If you do not map this column to the field at Uspacy, you will not be able to start the import. The system will definitely ask you to map it manually.

oimZ13s4IBmtZCroQCDubFiyg0ZyxZAklxFuVDCcDkSQ2FNUMFY1z01NTSBIiC6b6rjSicGmIQ3v8KgGaoIWkuMD7xBAFGCludjFaKOUSrgWqpzjOi088D8kM5_OINpqyyXR_k-J0DMrlccVoIXTwDw

If you do not fill out the data about the main email for an employee in the file, then as a result it will NOT be imported at all. And his/her data will not be entered into the system.

πŸ’‘In addition:

It is necessary to also have the Department and Country columns in the file and map them to the same fields at Uspacy.

8IS-RVfD4NDE3iKOUsZJudK6OpwI7RkqrKmxZHXpLi-LOYb5l4VuLofYx1AE8-aTaA6GARxTL8JQh1l_0qiKMCF92tp93LuD2w6JqvVobWYceXBasZNc4cpIK-9Q8ZSW32_eIk6QZ44x8Gnb0Im_QCM

☝🏻 If you do not do this, then after the end of the import, the employees will be added to the main department of the company. The system will warn about this in a special message.

8tS8I9Tf4A-__nCi1nd9qg1tVcetR7p7qGw1qfickiLCyt9qVVKaoYlTk1-rayjVgipjSg65vCRG5TPV69Hq6G6q6FbEgD47JKgCOxgzUFBJK1bDRH7cmYzN3QAAuDVVHX9M1gflj_4bCf-HU4EGaS4

You may not have the Country column in your file at all. In this case, this information will not be transferred to the employee profile.

If there is a Country column in the file, and it is mapped to a field at Uspacy, then in the second step you will need to map it.

At least one mapped field is required to start the import. Otherwise, the system will not be able to start data import.

πŸ’‘ To import employees, this field can be the main email address.

zSiOxL4N5nspYD_r7ENahxDdB4KES4HQqKzYhyuWe8W-mkkCQtE48k0A8q-PpwwTLGKxNKkCACFiMw0gdh4GHe5-jaq8BK0a1NJ3tj1GQwoANNhyrC2SpDhOUdXQDaYhECqCqX4yWc2PUm1RhrS-Xws

When everything is ready, you can move on ⬇️.

TdYMrBrFSc_FdIyHgZfOIpNcED-c-Ysayu7EgGK0HV47MsItwTIut8y2L3aIdKm7L-MrCS_d5cSMVy67UzcVTEZRHlC9aGFEj9LHLCHcp1eS7OEyUd7Gd_m9810NKZNvtT-4nkT4aJt-sGI64_ravl0

The mapping of departments and countries

In this step, you need to map the departments and countries from the file to the departments and countries at Uspacy.

The first is the Departments tab.

It will be available if there is such a column in the file and it was mapped to the Uspacy field in the Field mapping step.

Check if the mapping is correct. If the names map, everything will be filled out automatically. It will work if the department names from the file and the department names at Uspacy are identical.

yZZPl6gJxPRtjogu_11BRgSDE5ZM9yOeRtfjHFpNX-yHCoitbXRWYRPF05qPxUxmuuYX7dR_8GHB0GrQct9oFfJwijoh-QB-AknJpi0A13u44rYjlIQPkIVUExAiMygWf8c3H0gGYVLQHJ1bZoxtjQo

If the names do not map, you can manually map them.

80thsQUxCwhsMrHyVfzjzKQYBME9KF2p8zZX8tgryOjZZbmyxYXzHEOx1UeJnDiJsjK-OZqR9LTSluIO2DL3Jpo0q1TwjomTfArTUC5_HZ9AF3KOgDvrwrZNVC2fFiD9vxnLYF7q42X5T3GncD5e7fI

πŸ’‘ The system will automatically map the name of the main department of your company at Uspacy.

FIjUMQIvBZygAj6PZ7O3kyQPrG_lNHtpCK-okeoDS4EBUFF_pM4w7bYVPr5spMbA4Nq54u8vLFSBZes9eDi4A7PsTqGhqwR7xPwIKjvbReDrilB1pPSBep4HXcbmiNIGEAaZJBiQJbBc3Z9NXOFlS8c

If you leave it as it is, then after the import is complete, the employees will be added there.

Or if there is no corresponding department at Uspacy at all, it can be created in the import window at once. For this, it is enough to use a special button.

vjEXXx-I6yYOybGSsasYAjuj-KtFtR-EjsLNsUn-Pn3ZeEH7YrIU0y2rkzsw9_kEKJdFyLc39veESbmP73EwcUb7g36lLQvLMe4q85Nc54EeCcR6nV7phnNR4-XgDBnpD8agEzxEfkYtGbHBLd80dI4

The form for creating a new department will open directly in the import window.

D5txqk6fiTq_pAlI-tq5p6x_DnI5l0I3lLxQz3vknh-HEzTXprezGS8uItlP1j3eVMsdGiMHJYaskI7cOzrh_KVtYXMUAC_utImBvLZDDTP42z6vT7uvu9Qjf77t4X6KfLDueM4sWcRAr9x4pQnZjRY

You only need to fill out the fields and click Save.

t4R1YQ-xUzSZ-zVdd1Xc9hCt1nR5TBtrn3qT6qaWTL11JDDzMeL8XWxIdVr_dEJ-Dv9L5OmPYcdCqLy93oSMoSbJcRGj2EU_MKb0eE2aKAnezFiufGnobeAtxtMD-xskeL_6qYXqIYJdcGIzQgaVbNc

The newly created department will appear in the field for mapping at once.

wmEGtSw7xScBuYhEms0A7PDXqTPf-0_95vhFaP4qY9PVEvcqwUxF7h8xRkcQIQRNdhvI5EbnSxD3p8SL4JgLAsdExZn72qrlQPeFaT2SDP_5NHHd3tBV74dkCJ2n8lTO1p5jVDjorBEOkSb--6XXoqM

Next, you need to switch to the Countries tab.

It will be available if there is such a column in the file and it was mapped to the Uspacy field in the Field mapping step.

Check if the mapping is correct. If the names of the countries map, everything will be filled out automatically. That is, it will work if the names of the countries from the file and the names that exist in the system are identical.

O4PN4ZWJbYh_5Pr8tMukEVrBMcl18vsQbftskCXO2cNiLUqALKWqcxWhd8c_5MJfXHmRz8PYkNNJGnyvYvZtSzXKLnoHMMjJCAtLpvgsUIvY3f_BUOrU8eOJi4QT8uCOlw_FtEc4Zt7N2-3-gWrAVNE

If the names do not map, you can manually map them.

PkWNu9SqgljNLopDzadmwis14umtVcSYlYKV24ZqjNAwtY1pHfdMXlcHxaYH4fEWmt7zvTijT2GNjww7RvSImkkZGV0zAVHYJsvfR7mmXYctCPnTP-JINRwLLHi7aLYdK6tclHfzEfsI1ocv4nctm3U

The system in such cases will report that the mapping is Not selected.

P7mEME24ykjjgW3j0RoTBHHV75vmu9bLa6077Bveoc2sIfRXp0t51lQEk_bCaV3a3IftK1xFG-ojSMMRH6QfvW91I0fTjrTt9Fv8_RBMHuzPKm6Q0g82bqrRDEJX53wh5VULVAjWMw-VxkWKuQdU7lw

If you don't map manually, after the import is complete, the country information will NOT be transferred to the employee profile at all.

When everything is ready, you can move on ⬇️

The start and the result of import

After configuring the import parameters, the required mappings of fields, departments and countries, you can start the process of transferring employee data from the file to Uspacy. To do this, click the Start import button.

n-Gp8kV9RLAEdCrefIqar_Trn5YBh0139h-tNfA3eEEKoGjJCxI9ijeM9lOEyiy3D-wWJzVGhnSxe0V0iCO7a2-pNS3KqGs7KRxr6dVs-3QGOghPk9gM20psrav70Fbitik1qpw5lhm3zSQyBaVPc8E

Now just wait for the import to complete so that your employees can start working at Uspacy.

❗️ Do not close the page

ClVWcJv9MrVnDepzW9l62UD-K78Jv6V1G2Y1RLMoHn596G-ATvAVWvb_G6i1PeYWu__3sgaCj02tzh2QMhUO0iORs_qWJsGPPw0D1fbxLBuVEGzFHmR3vuEr7_0Eg4YrP314mbGbdImJbjXZUBOFmwE

If the import is successful, you will see the corresponding message πŸš€

wEJCMCa6DsX0ysV8iCd5vbC_bf_pyOJWPpWrF5IN-U7gq_JACJugHB30M8NL-ZfRZg04PGaLJ4ePbe70kTtOFW6GgkQsFM5Fpc_E2lcG1iHVVrDTbtGlOK_kdIkx8AAxazoSI99RVRxSOFS_kHQHoek

πŸ’‘In case of an error, you can try to upload the file again, map the fields and start the import.

Now everything is ready! Employees are transferred to your Space, added to their departments, and are part of the company.

a7rqMb0dOk1kmQpeshhKZ4iuEO9UTyTj1BXyH9pUsKLbHuuu1DFw6MQ9CK2PoTRE5efyURtz6H4k8-wWvBLbVhC1qUVKzRJQ6bxt_E7_Ly3DN8VeYHvq6eBhPpH97cFOI5k-VBqmVCyXauFbZj8JZLs

In order to successfully log in and start working in Space, users whose data was also transferred during import need to recover passwords from their accounts.

That is, perform all the same steps as in the situation when you simply forgot your password.

H3BRsTi861Pc3_g6XPElEtKQuZT-HeohlSfWIAohVjAMr8bjesVS1UFvEMcnfO0x4SgQzQ6FolVmrBe2k4YHQTCbxfvDaaS3GWIRCDBxB1AI3TWfMP74qh_3nBvBZk0lqHqW7oBmL-PcXIhoYCFmT0c

πŸ” You can read more about password recovery in the following article.

If you have additional questions or you need to contact the support, send a request to this email [email protected]

Created: August 2, 2023 / Updated: July 10, 2025