Documentation Index

Fetch the complete documentation index at: https://docs.revealdata.com/llms.txt

Use this file to discover all available pages before exploring further.

Upload Native Files - Reveal Upload Manager

Prev Next

The Reveal Upload Manager is a desktop software that enables users to transfer Native files, Load files, and Images straight from their PCs or their network to the appropriate data staging location for processing in Reveal. It accommodates large data uploads by ensuring efficient and rapid file management.

Upload Native Files

  1. In the Uploads modal, select Native Files for the Files setting.

  2. Select your desired Workflow.

  3. Specify whether you want to include duplicates by checking the Allow Duplicates checkbox.

  4. Choose the Reveal Upload Manager as the Upload Method.

  5. In the Files tab choose the Custodian, Location, and Source of the files.

  6. In the Notifications tab choose the teams or users that need to be notified after an Upload job is completed.

  7. After filling out all three tabs, click on

  8. You will be redirected to the following Uploads page:

  9. Here, users can Install the Reveal Upload Manager application, which is available for Windows, Windows (Command Line), MacOS, and Linux.

    Note

    Make sure that you are using the most recent version of the Reveal Upload Manager application. The application will display a message banner at the top within its interface when an updated version is ready. To download the new version, simply click on it, and it will be saved in your PC.

  10. Click on the Copy icon to the right of the URL displayed in Step 2. This will copy the Upload Token which is needed by the Upload Manager to find your data. The generated Upload Token will remain valid until the upload is complete. You can pause and resume the upload job as needed during this time.

    • The token is also accessible in the Uploads tab in the web through the A key icon representing security and access control in digital systems.  blue key icon in the far right of your upload project.

      Note

      Users can copy the access token and share it with other users to allow them to upload data directly from their local device.

  11. Open the Reveal Upload Manager application.

    Note

    The Reveal Upload Manager application automatically matches your operating system's light or dark theme. If you change your system theme while the application is running, the application updates automatically. There is no manual theme setting within the application.

  12. Paste the token you copied in the Upload Token field.  

  13. Click the Choose folder button for your upload.

    • For Native files, select the folder that contains the data you want to process.

  14. Choose your preferred language from the following 9 options: English, Spanish, French, German, Italian, Portuguese, Dutch, Russian, and Korean. You can change this setting at any time, including during an upload, and your selection will be saved for future sessions.

    Note

    Versions 2026.4.2 and later support OneDrive. Files are first downloaded and then uploaded to the S3 folder for processing. Because the process involves both downloading and uploading files, it may take longer to complete.  

  15. Click Start Upload.

    • Once the upload is initiated, it runs independently and does not require the browser to remain open or conduct any monitoring.

  16. Click the Advanced Settings button to open a pop-up where you can adjust the Upload Speed using a slider. You can set the speed to slower or faster as needed. This setting can be changed at any time, including during an active upload or while an upload is paused and resumed, and it will take effect immediately.

    • The maximum number of files that can be uploaded at the same time is equal to the number of CPU cores in your computer.

  17. The Activity dropdown will let you know when the upload starts and completes and other details.

    • You can see the progress both on the Upload Manager and the web.

    • The upload is separated into:

      1. Files: The full document or item you’re uploading.

      2. Parts: A smaller piece of a file. Large files are split into parts (16 MB–512 MB each) to make uploads faster and more reliable. Multiple parts can upload at the same time, and if the upload is paused or interrupted, only the parts in progress are affected. Any errors impact just the individual parts, not the entire file, and you can resume uploads without starting over.

      3. Size: Sizes of the files.

  18. During an upload, users can choose to Pause at any time. When they select Resume, the upload continues from where it left off using the same folder path that was originally selected. During the resume process, Upload Manager automatically checks any files previously marked as Not Found. If those files have been restored or are now accessible, they are uploaded. Files that are still unavailable remain marked as Not Found, and files that have already been uploaded are not uploaded again. If users select Start over, the upload begins from the beginning.

    • To prevent conflicts, such as using the same token in multiple instances, the system locks the upload while it’s active. When you exit and reopen the app, you may need to wait about 60 seconds for the lock to clear because the database updates every minute to indicate the upload is still in progress.

  1. If an upload finishes with errors, users can review the failed files and choose to Retry Failed Files, Mark as Done, or Cancel upload. These actions remain available even if the token field is empty, preventing the upload from becoming stuck in a disabled state.

    • If the upload is interrupted because too many files cannot be found, the upload session remains preserved. Users can choose to Upload Anyway to upload only the files that were found, or Choose a Different Folder to rescan for the missing files. This allows you to continue the upload without starting over.

Note

When an upload is complete, it follows the workflow selected in the Setup tab. For example, if the workflow is set to Upload + Process + Promote to Review, the system will automatically start processing as soon as the upload completes, with no extra steps required.

When uploading native files, Reveal Upload Manager will generate a metadata preservation CSV file that captures key file system attributes, including OS last access time, last modified time, last metadata change, and creation time. These values are recorded prior to uploading the files to S3, to prevent the loss of metadata that would otherwise be overwritten during the upload process. During processing, this preservation CSV is used to restore and repopulate the original timestamps on each file.

Performance

Upload speed depends on your local environment. The system is designed to fully utilize available resources, so performance is generally limited by your internet connection and CPU.

In high capacity environments, the system can achieve speeds of up to 2 terabytes per hour and 2,000,000 files per hour (approximately 555 files per second). With uploads as large as 10 terabytes and up to 10 million files in a single job.

Footer Design