Convert Box Notes
Learn how to convert Box Notes to DOCX files when migrating to another platform.
Table of Contents
Overview
The Allow Rendition setting determines how Box Notes transfer from Box to the destination platform. This setting is disabled by default. If left disabled, Box Notes will be transferred in JSON format. When this setting is enabled, Box Notes will be transferred to other platforms as DOCX files.

Job Behavior
The job will handle Box Notes in the following way to ensure job performance.
- The first job run will pick up all box notes.
- Delta job runs use Box native event detection to identify changes. Since Box doesn’t support native event detection for Box Notes, Box Notes files will be ignored. There may be exceptions where Box reports changes to Box Notes. When this occurs, the job will pick up the changes.
- To migrate updated Box Notes, you will need to perform a soft reset on the job. The job will perform a full crawl of the content, which will migrate the updated Box Notes. This is recommended at the end of a job to ensure all Box Notes updates are transferred.
You can choose to have DryvIQ always transfer all versions of Box Notes by editing the Box suppress_notes_versions configuration option. See Configuration Options for more information.
Unsupported Box Notes Features
- Preview images are not supported when converting Box Notes to .docx files since there is not enough information available for DryvIQ to download the image.
- Edits to the .docx file on the destination are not transferred to the original Box Note on the source for sync jobs.
- You cannot enable Box Notes migration using the scripting block when creating the job. Instead, use the Allow Rendition toggle in the UI to enable the feature.