If SelectionHandlers is set, can it appear in the toolbar, as shown in the image below?

[dludream]

If SelectionHandlers is set, can it appear in the toolbar, as shown in the image below?

[mohammadrezwankhan]

[GitHubRulesOK]

If you already set to one (or two) key press via the KEY= then it is quicker than select a dropdown and pick from that
this was one KEY principle SumatraPDF was built on that keys avoid cascading deeper and deeper GUI controls

[GitHubRulesOK]

@kjk whilst I understand the NEED to keep Shortcuts, External Viewers, and Selection as seperate groups if the CUSTOM icons was extended to selections It would be one click on main taskbar

SelectionHandlers [
	[
		Name = Summarize locally "$${selectionfile}"
		Exe = "C:\windows\system32\cmd.exe" /r type "$${selectionfile}" &echo.&pause
		ToolbarSvgIcon = <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><rect x="0" y="0" width="24" height="24" fill="#fd1"/><text x="2" y="7.5" font-size="9" fill="black" font-family="sans-serif">Send</text><text x="7" y="15" font-size="9" fill="black" font-family="sans-serif">As</text><text x="0.5" y="23" font-size="9" fill="black" font-family="sans-serif">TEXT</text></svg>
		Key = SHIFT + 4
	]
]

[kjk]

Implemented in 478f911, so it'll be in the next pre-release build.

A selection handler now takes a SelectToolbarNameOrSvg value. When it's set, the handler also gets a button on the toolbar that pops up over a text selection:

SelectionHandlers [
  [
    URL = https://duckduckgo.com/?q=${selection}
    Name = &DuckDuckGo
    SelectToolbarNameOrSvg = Search
  ]
]

The value is the button's text. Unlike Name it's shown exactly as you type it — no & hot-key handling and no translation. Keep it short: the toolbar sits over what you're reading, and each handler you add makes it wider.

If the value starts with <svg, it's an SVG icon and is drawn instead of the text:

SelectionHandlers [
  [
    URL = https://duckduckgo.com/?q=${selection}
    Name = &DuckDuckGo
    SelectToolbarNameOrSvg = <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"><rect x="0" y="0" width="24" height="24" stroke="none"></rect><circle cx="11" cy="11" r="7"></circle><path d="M21 21l-4.35-4.35"></path></svg>
  ]
]

Icons are in the same format as ToolbarSvgIcon for the main toolbar: 24x24, stroke="currentColor" and fill="none" so the icon picks up the theme's text color, plus a full-size <rect> so its background comes out transparent. Tabler Icons are already in that shape. Without that <rect> the icon renders as an opaque box, which is very visible in the dark theme.

There's a screenshot of both forms in the docs — Search and a magnifier icon sitting after the built-in Copy / Translate / Highlight buttons.

Handlers without SelectToolbarNameOrSvg don't change: they stay in the context menu and the command palette as before. The toolbar itself can be turned off with SelectionToolbar in advanced settings.

Docs: Customize search / translation services.

[dludream]

Great! Very convenient.