Menu
Feedback
Known issues
MasterData worksheet import/export returning timeout
Storage
ID: 400265
Backlog
Published on10/16/2025
Last updated on10/16/2025
2 min read

Summary

When exporting and/or importing an entity, a timeout may occur in the following scenarios:

  • Entity with many fields;
  • A certain field with too much information;
  • Many documents in the entity. These scenarios can lead to a very large file size, burdening the worker who exports/imports the documents to the file/database, resulting in a timeout response with an aborted request response.

Simulation

For export case:

  • Access Master Data CRM (for example https://my-account-here.vtexcrm.com.br);

  • Access a Form Application with fields that contain a very large amount of data per field (ex: images, videos..);

  • Click on the "Export XLS" button:

  • On "Data Export" popup, click on "Select all fields" to check it:

  • Go back to the Applications page;

  • Click on the "Exports" button:

  • You can follow the request on "Export Status" (for example: https://my-account-here.vtexcrm.com.br/ExportStatus/Index);

  • The email will not be sent to the user.

For import case:

  • Access Master Data CRM (for example https://my-account-here.vtexcrm.com.br);

  • Click on the "Import" button:

  • Choose the Data Entity and the .xls file:

  • Click on the "Import" button;

  • The import will start, it will be processing, and then you will be redirected to Import/ExecuteImport (for example https://my-account-here.vtexcrm.com.br/Import/ExecuteImport), and the following error will be displayed:

    This page isn’t workingmy-account-here.vtexcrm.com.br took too long to respond.HTTP ERROR 504

Workaround

There are 3 easy ways to use workarounds in this case.

Filter only the documents you need, if you don't need the whole entity, and then, export them:

Only select the fields you really need, if you don't need the whole entity, and then, export them:

Separate the spreadsheet to be imported. For example, a worksheet with 60,000 documents, divide it into 6 spreadsheets of 10,000 documents and try to import it again. Remember that we don't have an exact number. Dividing the file into up to 10k documents was a suggested example. It will depend on the number of fields/columns, the size of each information in the field/column, the file size, the worker, etc. There are some factors that can affect the expected import.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX Community
Join our community
Request VTEX support
For personalized assistance, contact our experts
Open a support ticket
GitHubDeveloper PortalCommunityFeedback