Guides

BOTA Configuration

The BOTA interface is used to display the Bookmarks, Outline, and Annotations lists of a PDF document.

Through BOTA configuration, you can control which types of tabs are displayed and what menu options are available within each interface.

Configure BOTA through ComPDFKit.getDefaultConfig({ global: { bota: ... } }). If you do not provide this configuration, the SDK shows outline, bookmark, and annotations tabs by default.

Configure Enabled Tabs

Use CPDFBotaConfig.tabs to specify which tabs should be enabled:

ComPDFKit.getDefaultConfig({
  global: {
    bota: {
      tabs: ['outline', 'annotations']
    }
  }
});

Example Result:

Android	iOS

Configure Annotation Menu Options

BOTA supports setting global menus and individual annotation item menus for the Annotations list interface:

ComPDFKit.getDefaultConfig({
  global: {
    bota: {
      tabs: ['outline', 'annotations'],
      menus: {
        annotations: {
          global: botaMenus('importAnnotation', 'exportAnnotation', 'removeAllAnnotation'),
          item: [
            { id: 'reviewStatus', subMenus: ['accepted', 'cancelled', 'none'] },
            { id: 'markedStatus'},
            { id: 'more', subMenus: ['delete']}
          ]
        }
      }
    }
  }
})

Example Result:

Android	iOS

Annotation Global Menu Options

Option	Description
importAnnotation	Import annotations
exportAnnotation	Export annotations
removeAllAnnotation	Remove all annotations
removeAllReply	Remove all annotation replies

BOTA Configuration Fields

Field	Description
tabs	Tabs displayed in the BOTA panel. Supported values are outline, bookmark, and annotations.
menus.annotations.global	Global actions displayed in the annotations list toolbar. Use botaMenus(...) for concise configuration.
menus.annotations.item	Actions displayed for each annotation item. Use subMenus to limit nested review or more-menu options.

Note: BOTA menu customization applies to the SDK-provided BOTA panel. If you build a custom BOTA screen in React Native, handle those menu actions in your own component.

Annotation Review Status Submenu Options

Option	Description
accepted	Accepted
rejected	Rejected
cancelled	Cancelled
completed	Completed
none	No status

More Menu Options

Option	Description
addReply	Add annotation reply
viewReply	View annotation replies
delete	Delete annotation