How to Place Acrobat Custom Tool Buttons on a New Line
Question details
The user wants to know if it is possible to arrange CustomToolButton controls onto separate vertical rows using Acrobat JavaScript.

- Product
- Adobe Acrobat
- Device & OS
- not provided
- Scenario
- Customizing the user interface or toolbars in Adobe Acrobat by adding custom JavaScript buttons.
- Observed behavior
- The user is unable to find a supported method to control the placement of CustomToolButton controls or force them onto a new line in the interface.
Before attempting to modify Acrobat's interface, ensure you have administrative rights to edit application-level JavaScript files and understand that Acrobat's API has strict UI layout limitations.
Understand Acrobat's Toolbar Layout Limitations
Adobe Acrobat does not provide a supported JavaScript method to force custom tool buttons onto a new row.
Adobe Acrobat has strict limitations regarding user interface customization via JavaScript. Specifically, the API does not provide a supported way to control the exact vertical placement of a CustomToolButton or force buttons onto additional rows.
When buttons are added via the JavaScript API, Acrobat automatically places them in the Add-on Tools pane or standard toolbar sequentially. You cannot define custom line breaks, margins, or vertical stacking using standard JavaScript commands.
Consult the official Adobe Acrobat JavaScript API Reference for the 'app.addToolButton' method. You will observe that there are no parameters available for line breaks or specific row positioning.
When executing your script to add multiple buttons, accept that they will be arranged horizontally by default within the allocated toolbar space provided by the Acrobat interface.

Looking for a Simpler Way to Manage PDFs?
While complex JavaScript toolbar customizations in Acrobat can be highly restrictive, WPS Office offers a highly intuitive, built-in PDF editor alongside its Word, Excel, and PowerPoint alternatives. Enjoy a lightweight interface with ready-to-use tools without the need for complex scripting.

Frequently Asked Questions
Can I group custom tool buttons in Adobe Acrobat to save space?
While you cannot force line breaks for buttons, you can organize related scripts into a custom drop-down menu using the 'app.addSubMenu' method to save horizontal toolbar space.
Why won't my Acrobat custom tool buttons show up at all?
Ensure that your JavaScript (.js) file is placed in the correct application-level JavaScript folder for your OS, and verify that you have enabled JavaScript execution in Acrobat's Preferences under the JavaScript category.
Are there any third-party plugins that allow multi-row custom toolbars in Acrobat?
Yes, some third-party Acrobat plugins developed using the Acrobat C++ SDK can create custom toolbars with multiple rows, which is a capability not exposed to the standard JavaScript API.




