Skip to main content
Before your users can split documents, enable the settings that Box Doc Split depends on. Which settings you need depends on the split type and on how you run Box Doc Split.

​
Enable Box Doc Gen

Box Doc Split is part of Box Doc Gen, so Box Doc Gen must be enabled for both split types.
  1. Go to Admin Console > Enterprise Settings > Content & Sharing.
  2. In the Box Doc Gen section, select Edit Configuration.
  3. Enable Box Doc Gen for your managed users, or for selected users and groups.
  4. Select Save.
For more details, see Enabling Box Doc Gen.

​
Enable Box AI for smart split

A smart split uses Box AI to decide how to group pages, so Box AI must be enabled for the users who run smart splits. A manual split does not need Box AI.
  1. Go to Admin Console > Box AI > Settings.
  2. Under Access Permissions, make sure these services are enabled:
    • Files
    • AI via API/MCP/A2A/CLI
  3. Save your changes.
For more details, see Configuring Box AI.

​
Add the required scopes to your app

If you split documents through the Box API, the app that makes the request needs the Manage Doc Gen scope. For smart splits, the app also needs the Manage AI scope.
  1. In the Developer Console, go to Platform Apps and select your app.
  2. On the Configuration tab, go to Application Scopes > Content Actions.
  3. Select Manage Doc Gen.
  4. For smart splits, select Manage AI.
  5. Save your changes.

​
Next steps

Last modified on September 23, 2026