2026.3 Add-on API changes

[NVDA Add-on API Announcements]

Add-on API changes have been merged, planned for inclusion in the 2026.2 release:

"Add multi routing gesture and select with routing command #20028".

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Deprecations:

• The braille.BrailleDisplayGesture.routingIndex attribute is deprecated. Use the cellIndexes attribute instead

[NVDA Add-on API Announcements]

Add-on API changes have been merged, planned for inclusion in the 2026.2 release:

"Support multi routing on Freedom Scientific displays #20250".

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Deprecations:

• brailleDisplayDrivers.freedomScientific.RoutingGesture is deprecated. Use KeyGesture instead. (#20250, @LeonarddeR)

[NVDA Add-on API Announcements]

Add-on API changes have been merged, planned for inclusion in the 2026.3 release:

"Add braille text wrap modes with continuation marks #20146".

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Deprecations:

• The braille.wordWrap configuration key is deprecated and bridged to braille.textWrap

[NVDA Add-on API Announcements]

Add-on API changes have been merged, planned for inclusion in the 2026.3 release:

"Add sequential two-flick touch gestures #20086".

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Deprecations:

• In touchTracker, the module-level action_* string constants are deprecated. Use the corresponding TouchAction enum members instead (e.g. TouchAction.TAP, TouchAction.FLICK_UP)
• In touchTracker, actionLabels is deprecated. Use TouchAction(value).displayString instead.

[NVDA Add-on API Announcements]

Add-on API changes have been merged, planned for inclusion in the 2026.3 release:

"Add Chinese Word Segmentation #20183".

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Deprecations:

• * The useUniscribe attribute of textInfos.offsets.OffsetsTextInfo and its subclasses is deprecated, use charSegFlag and wordSegFlag instead.

[NVDA Add-on API Announcements]

Add-on API changes have been merged, planned for inclusion in the 2026.2 release:

"Convert ui.browseableMessage to wx.html2.WebView #20251".

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Deprecations:

• The URL_MK_UNIFORM, DIALOG_OPTIONS and HTMLDLG_* constants in ui are deprecated with no replacement, as the COM-based HTML dialog infrastructure has been removed.
  Use gui.message.HtmlMessageDialog instead.

On Friday, June 12, 2026 at 5:08:20 PM UTC+10 NVDA Add-on API Announcements wrote:

[NVDA Add-on API Announcements]

Add-on API changes have been merged, planned for inclusion in the 2026.3 release:

"refactor(braille): deprecate moved facade symbols and add getHandler() #20390".

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Deprecations:

• The symbols that moved out of the braille module facade when it became a package are deprecated. Accessing them as braille.X still works but logs a deprecation warning; import them from their new location instead, as listed below:

• braille.BrailleDisplayDriver is now braille.display.driver.BrailleDisplayDriver
• braille.BrailleDisplayGesture is now braille.display.gesture.BrailleDisplayGesture
• braille.getSerialPorts is now braille.display.getSerialPorts
• braille.getDisplayList is now braille.display.getDisplayList
• braille.getDisplayDrivers is now braille.display.getDisplayDrivers
• braille.RENAMED_DRIVERS is now braille.display.RENAMED_DRIVERS
• braille.DisplayDimensions is now braille.display.DisplayDimensions
• braille.Region is now braille.regions.base.Region
• braille.RegionWithPositions is now braille.regions.base.RegionWithPositions
• braille.TextRegion is now braille.regions.base.TextRegion
• braille.rindex is now braille.regions.base.rindex
• braille.NVDAObjectRegion is now braille.regions.NVDAObject.NVDAObjectRegion
• braille.ReviewNVDAObjectRegion is now braille.regions.NVDAObject.ReviewNVDAObjectRegion
• braille.NVDAObjectHasUsefulText is now braille.regions.NVDAObject.NVDAObjectHasUsefulText
• braille.TextInfoRegion is now braille.regions.textInfo.TextInfoRegion
• braille.CursorManagerRegion is now braille.regions.textInfo.CursorManagerRegion
• braille.ReviewTextInfoRegion is now braille.regions.textInfo.ReviewTextInfoRegion
• braille.ReviewCursorManagerRegion is now braille.regions.textInfo.ReviewCursorManagerRegion
• braille.getControlFieldBraille is now braille.regions.properties.getControlFieldBraille
• braille.getFormatFieldBraille is now braille.regions.properties.getFormatFieldBraille
• braille.getPropertiesBraille is now braille.regions.properties.getPropertiesBraille
• braille.getFocusContextRegions is now braille.regions.focus.getFocusContextRegions
• braille.getFocusRegions is now braille.regions.focus.getFocusRegions
• braille.invalidateCachedFocusAncestors is now braille.regions.focus.invalidateCachedFocusAncestors
• braille.BrailleBuffer is now braille.buffers.BrailleBuffer
• braille.BrailleHandler is now braille.brailleHandler.BrailleHandler
• braille.formatCellsForLog is now braille.brailleHandler.formatCellsForLog
• braille.FALLBACK_TABLE is now braille.brailleHandler.FALLBACK_TABLE
• braille.roleLabels is now braille.labels.roleLabels
• braille.positiveStateLabels is now braille.labels.positiveStateLabels
• braille.negativeStateLabels is now braille.labels.negativeStateLabels
• braille.landmarkLabels is now braille.labels.landmarkLabels
• braille.FormatTagDelimiter is now braille.formatting.FormatTagDelimiter
• braille.FormattingMarker is now braille.formatting.FormattingMarker
• braille.fontAttributeFormattingMarkers is now braille.formatting.fontAttributeFormattingMarkers
• braille.getParagraphStartMarker is now braille.formatting.getParagraphStartMarker
• braille.AUTO_DISPLAY_NAME is now braille.constants.AUTO_DISPLAY_NAME
• braille.AUTOMATIC_PORT is now braille.constants.AUTOMATIC_PORT
• braille.BLUETOOTH_PORT is now braille.constants.BLUETOOTH_PORT
• braille.USB_PORT is now braille.constants.USB_PORT
• braille.NO_BRAILLE_DISPLAY_NAME is now braille.constants.NO_BRAILLE_DISPLAY_NAME
• braille.CONTINUATION_SHAPE is now braille.constants.CONTINUATION_SHAPE
• braille.CURSOR_SHAPES is now braille.constants.CURSOR_SHAPES
• braille.SELECTION_SHAPE is now braille.constants.SELECTION_SHAPE
• braille.END_OF_BRAILLE_OUTPUT_SHAPE is now braille.constants.END_OF_BRAILLE_OUTPUT_SHAPE
• braille.INPUT_START_IND is now braille.constants.INPUT_START_IND
• braille.INPUT_END_IND is now braille.constants.INPUT_END_IND
• braille.TEXT_SEPARATOR is now braille.constants.TEXT_SEPARATOR
• braille.CONTEXTPRES_* is now braille.constants.CONTEXTPRES_*
• braille.focusContextPresentations is now braille.constants.focusContextPresentations
• braille.pre_writeCells is now braille.extensions.pre_writeCells
• braille.filter_displaySize is now braille.extensions.filter_displaySize
• braille.filter_displayDimensions is now braille.extensions.filter_displayDimensions
• braille.displaySizeChanged is now braille.extensions.displaySizeChanged
• braille.displayChanged is now braille.extensions.displayChanged
• braille.decide_enabled is now braille.extensions.decide_enabled
• braille.BrailleMode is now config.configFlags.BrailleMode
• braille.TetherTo is now config.configFlags.TetherTo