Uspacy Knowledge Base
All materialsSettingsImport

Tasks import from a file

Tasks import from a file

Here we will tell you how to upload a file for import, map the fields from the file to the fields at Uspacy and how to start tasks import

If you want to transfer the tasks that you previously worked with in another service to your Uspacy Space then simply import the data from the file.

💡 Only an administrator or superadministrator of Space can do this.

Uploading a file

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

4rT8-U147fm3C79WDiIbti1pUsRqqrqW73pSq2cZRl7emJCYdrwlrBpyb2l7BtXqo5h5cXYyZDLhKAtKkD9QSsRTH91fLwUBP2aU-GR5j51f9jINDjn_PnvaUs5ql4mWwY0MmxdHxPhx6DkvVUG5FJo

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 a separate task.

MgENjOQZ_83aeu8tWOSgGbemsnG2BUvF54sONqDMMrlUY5KSHn4h42WAgDIDCORzj_okJ9hZHnR-rc7r7MsxxChM556Br0DTDTvNJ_Q034i-8yW7hNb0ISRT2JDyTsUTFuvFe56vBVCbU8MV0jz9RHA

Pay attention to the import recommendations.

xiTQCIOTIuzpZ4qmBc1ZXBpu2zBD77n9dIFuxlEGFeEzfdwAOCK8zV4XnX2G0JT9alOQDyikqqv3EATwj9jv1t0sZuooxDkkE3uukQZaJ3qV1JvjxAge_LA3rlOkpzZpLXKF-1Mt9tVST__P3Gnd5Tc

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.

D_MH7-9SfA3WLV-FCLnYsfkegBs9ITF7atiBYZIFmMgVLN9yhhZMStoJ5fINS9wR52fR0ln9NMjgpDcONn1Hj-nariPLluILoxc_RIVSvFcgGsbtGM5DDbDI0SBAY-DiI579661-Sxzgfiw3iEs5N0U

Preview and fields mapping

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

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

💡 Advice

1LI-xQor2b5aGgMEskmofhTi_XMDUXwBYkWV5JqGAhQD2suX_SM0PNuft8dkC5MnVvigDeFdjpIWsQ22j6b9Z7yhfHeGAuh_YAZnNraLaKbdloRVLovKJxjgjXfgZqmBs1el_6GU-rKJPL0wSNBTUnQ

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. A task will be created as a result of the import.

_PbEnPZcfEF8Dgbx_BETZsFqqxdgVIXn-x-8XOyLwhKbjzucMzMqEyN1ojeWdeyHstHS-i0668Tw_6oKbwPbxFzTeI7NOQI8H7uV5obrtgX7Fs9jqUpkss8MEVYDoLeL29k7HRx48YnTnOzssQ8bfVw

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

aGDXzOGuxQW260T_LlPKdmA6abxK3xQYPKOetPpdOjTJBo5FLbAF0SXhA7tiI3RIp2keAmqBQYQvpUHDi3VOcMVgdaZAknf6V4ccukVhk3fzEaesLHRdNuxUm-4RE098HSJCxS70NIJgfQq4toW2pjA

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.

VZ1Ff6IzZjN_FSsWbgLVxeQgMNVe8oxQXvNjGtPdrleSSmIYQX-Q4dfc-PT1-hYNQpwohHFnLG9jV-Bsw5iF96NX_iwC4JX7fzBDnKz4d6zRsx0Cod62zwJiZxh67L271LHTyxcHr8tKy_jWHB8elCs

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

9XBa9crURWVkYFndikZ6BAqi8FJpRP85jIysci-4ZRTUcGu8ffYaD9DkwbO1G8x-eUHiJ_Q_pU2p_1TZgqkIc6uZmo62IPykJt06z_6Ad_Tzku9X-6zVd8UWhLWMYvk37TILQiPURWa6Zyzl0TRs0pU

❗️☝🏻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.

BLbYlLRMiBApdBgHpwDQk8Nhpdv5_TKmLD6eYu9s20m9ULqicvwiUhIiWDH7GLaHFsyihrgHO3ja566r8vMNSm-0Fa6a7bx8PdhA3R26zmTdH_vGGZvTrKiE0uBbInVa8cYT85HT2plS-nJpMdp4HdY

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

g6E34JaoOtMHJJiRR9PdOUG3_GAxmlmhJ9bVJdoLEarMuMF2WErE7zTcAxmT9KPEOvGdst6j67m_1-A00x-6LHPCqlq2QYkdkRGpBHjurRHTQ_eG5vdI_hsoeMRf9S-i-YmurnkFNNSgQTth5w2VUwo

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.

XuLclBAJdFa0-qkM1fzLelxxl-ztSh1E139_WLdaoARKdro5f0XtxcAcJQvotEpb4JxRJ1pGM9YsOypQNhMoeGd5JZGIWKGg3XLZTEC82k7-sqyz6gNWstZTxGK5vPgqiMDeGKQZjkSG0RnY3jOjc94

❗️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-48-50.png

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

iDpCWiH72kyiAh8Lacn-hUgY1Nh0nWXW7znmZs6bwlOr6nyTMZPw0hTeE4RtCL5QTebuWhu_KV8vTuUH21QlsJldWeRH8NuY-RhZ5v4AdX6H2SldwqUL7SrA4CSoHnJv9ffpDZSIgSQonffmImHzSAI

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.

jUF0y4QvoET_J4GEAXz1qxGCnQWqSD-t-SYV3teCz-kN_ot5F_Q4mgIINvkAj8F9ZChVrxUNJRKFbXD_IS5hysBhpuhz_bptSGkIfpv_areJxcDrENwM8TCgg7iwPQ3CT6SIqQzh8Byrf8jf9Qv3lPo

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.

Lc4w-rrsWf_GG-p2ve3TOlFVTeUOVv98zu4taNLhkwCzAxfyrOIvX93xLSlqOGUjTDNVDaBOsxK1pQseFP3W2ZVXH2G3qtqr31GhRK4xakWACGcrb6QjlBfs-0yUpcx35n18bh1gfcmL4b1AF6Oyqj4

Peculiarities of fields mapping

To continue and correctly import tasks, you must have the Status and Priority columns in the file and map them to the fields of the same name at Uspacy.

Dr7HW6vZHQPiTIVXQEGE_cjx42Ux5mA3RvvEa0lRcHTsVxsk0pxxT1kNtmSol1UaB1hzWR9Tk7lzI-1rYtR-0Kc3sLAH6yYx38iu9RNeNeu2T0kcCXMcp2LwyMYdYOU4MErPS7mlBpXVjQNxG_Z2OqE

❗️If you skip this and start the import without mapping these fields, all your tasks will be transferred with the status Not scheduled and the priority Neutral.

QkCfMcaBeE0hX8265_P0SHYlx6by56BkDNOYKJ1M8tCkkVljZv4sJZNG-xJzLm7ypkIiPjxP_HbXCBMs2vzzfHqmaYibl6AszA96RZ-ocYjC6ZAXCuKEDqqPbjiL9ghxg7AYLcxvdL2zm00wz-PWqtY

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

R8ObXQU9yS-yOwPB3Ho1i53PX6jRBN2xERrvXBgUSSwbqQQeJ7_SoFmPsxaYTCdXBPr5V0b9my_LM_IuowTTqy3GeN58OzY-86_S7p348uFaiIwLS0stGLiLSePD4PrA6HkM95sWTiuavBiGXMYDXTw

Data from fields left unmapped will not be migrated. Remember about this when starting the import. But the system will allow you to go back and map the fields so that you don't accidentally lose important data.

💡 Pay attention!

OSyVt5MfjHWQ4mWzUdrO_fLDb7J-B6vXZvs8KVceUbjSCSUz7FCM_y5rhsIv9iVZHbx8-x0XJbmeUw3fitJDNwsBhpMhbuN_qhVF47cW1RJzgTJ-4i8_Dl8DylFA-EXjKAAdS9rCOJyoTyyvh6ekSGg

When everything is ready, you can move on ⬇️

xzfD2lKbrnnqmZGwGv-3Dhi7cU7vwMWjps9nDgStvzTOuJcCOFp1EMRRK1cLrjw2wm18fJyAEq0B_c0vW3wf2mx1cZhTGkDigsYFsNuNJVk9ao2ZWUCCPhXQfzLhU_w54towOMX_7Im9m-ppLRBfYoQ

Mapping of statuses and priorities

In this step, you need to map the statuses and priorities to the statuses and priorities file at the Uspacy tasks.

The first is the Status tab. Check if the mapping is correct. If the names match, everything will be replaced automatically. It will work if the names of the statuses from the file and at the Uspacy tasks are identical.

JxhHRiS5Omf6EznlM3PrmnHBwUg_Ae88myzX5nmxA0G0DMzB9EmX_myNVybsnnYxnp1Gdh2L_8B_yFxGxUxXp3kCqUfgTF00Hu9QzIeR8NtzeKF64DLOi7tB8DilvAuum4Iysby7RbY03NaAEvvudW8

Of course, everything can be changed manually if necessary.

I_fGScLho3MINoHt7G5kLeg1Q8fEnEFjuRigDZa59JAvHad7HwHOm_JbmbyUVeI_mGEYak-Aiv30Lim2B0EkSkiFdwunz1OH6AQvXzYFyuesQxAW6jKRhbYdKMYtoZl5SViNK0JS1JSrgxOZ9-7q_Ns

When the statuses are mapped, the same should be done in the Priorities tab. If the names match, everything will be replaced automatically. It will work if the priority names from the file and at the Uspacy tasks are identical.

8oY7ZkzNs0rpVaZfpl32aheF6FLg8XcQp-v97V6Kleic28AenjAls9OIn1o4IufAkinGKTkOAO0hHu49U-VH8nVkr7_atDxfeYKY6EIGtKmx8SWek4ZIRCh2aprKxJS0TyF552GCraH0dePGvWdxPWE

You can also change the priorities manually.

4Y29DmeH3xWyybOPC0lcCQkKAQh1VFbY18whdIamqXl8_lcRUmMCcp1CgXaGDFc3B_ENRbUJGA7WqyrquJxJnxFPmeNlz5m36TYIuWju6xAWJ4BUzDlFpZWFxXP46UAQ0HpnOTQc6AfoR0iS5jPD-hk

Mapping of users

When you have to map a user type field, for example, it could be the Task creator, Person responsible, Participants, Observers, then map the users from the file to the users at Uspacy before starting the import. To do this, switch to the appropriate tab.

k-o3iNPSUL0_hgx6ERcHRfDkL2P-m38nr94vnXZebuE8ZCA8RhFk1JTGcUbdwGO-H42Ju8ckqYAacrb8zAuPNpLa36w5gHt8teb8GTEXn6d3FZ1aHSl1wErbOzhI1a0zlI2gr5J36qdnJRDH3V0w6zU

If the names and surnames are the same, then they will be mapped at once. If not, you will have to do it manually.

gHC3ZwSDrHQqa8JIv69UKfbJFBPbcDY6TDg50t4hCQ6iseC5aq32CefLFNcsV23Cb07auN4UgGBkhvWlHsLVLvTtA7P7Q2hSnlyhr2dSXK_Eup4p9yAXDetgIRdAZbMzIqEend6beaqd5VJu5UlVIHs

When it is ready, go to the next step.

Start of import and the result

After configuring the import parameters, the required field mappings, statuses, and priorities, you can start the process of transferring tasks data from the file to Uspacy. To do this, click the Start import button.

R_nIO45EzwPonhYTVioBYBbXxfolAO4RnaTEWsl0YD20XygEs5mBgftH0a_iWrqVSYQqEJGQ_75gEshg4QCZEQo7CMy_WKQR9mH_HIBEiRGNA7SLGZs9bbD0mpQjeF-sexZktAsYcVN1PDnjfGWFOM8

Now just wait for the import to finish to start working on your tasks at Uspacy.

❗️ Do not close the page

qlRWqBaGu9vP78oi08UycMY9L_D6sTCxCCqVEx7PfnTuy8R7UwHhaohJwFl7xSHruVQ7cpCYIeGr1o0SfdogdTm5lrwCoeIdysJIXTkxu__eeYvS_nYZD5bYbc6ZWifof6FaIYLrILoozZ6SOOxIxEE

If the import is successful, you will see the corresponding page 🚀

Nz3ZJBOiyuMj-JHT8VKMNRbvVLRyvtYhSRigzzEob4bFrNfyFz2LYYWnXTskUlh7DKGUp_EmG1k49U_2o0cH4PcvcGUt9NoxnIspn-cUtwWbtVOx_WQpnfsI_poh3ngsR7TZTBleHlsIDs72ae4lCKE

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

Now everything is ready! Tasks have been imported to your Space, you can start working on them.

GJdP5ytMut4ciLMRI5f7Hq0ummFY1JOgeT9-sNx7z2UXcYxCAyk3KKWqbl9WQJJXbzqnVBUc1K7w2-eF_jqyALbAHNU2DUa2xN0SNkuLRsVEYXpIgOxki0Ub3dfo7pT9oTuvRxB_fsQZVgNrQoJ1kUQ

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

Created: July 20, 2023 / Updated: July 10, 2025