[PR #18116] Add icon override setting for newTabMenu entries #31452

Open
opened 2026-01-31 09:47:24 +00:00 by claunia · 0 comments
Owner

Original Pull Request: https://github.com/microsoft/terminal/pull/18116

State: closed
Merged: Yes


Summary of the Pull Request

This PR is to allow users to set a custom icon for entries in the new tab menu for "action" and "profile" type entries.

References and Relevant Issues

This PR is in response to #18103

Detailed Description of the Pull Request / Additional comments

It is now possible to specify an optional "icon" setting for any "action" or "profile" type entry in the "newTabMenu" JSON settings. When specified, this icon will be used as the menu icon for that action/profile in the new tab menu. If not specified, the action/profile definition's default icon will be used instead (if present).

The Cascadia settings schema ("doc/cascadia/profiles.schema.json") has been updated to reflect this.

Validation Steps Performed

Manually tested with multiple combinations of icon settings:

  • ActionEntry:
    • valid path in action definition and new tab entry (renders new tab entry icon)
    • valid path in action definition but no path in new tab entry (renders action definition icon)
    • no path in action definition, valid path in new tab entry (renders new tab entry icon)
    • invalid path in action definition, valid path in new tab entry (renders new tab entry icon)
    • valid path in action definition, invalid path in new tab entry (renders no icon)
    • invalid path in both (renders no icon)
    • no path in both (renders no icon)
  • ProfileEntry:
    • valid path in new tab entry (renders new tab entry icon)
    • no path in new tab entry (renders profile's default icon)
    • invalid path in new tab entry (renders no icon)

PR Checklist

**Original Pull Request:** https://github.com/microsoft/terminal/pull/18116 **State:** closed **Merged:** Yes --- ## Summary of the Pull Request This PR is to allow users to set a custom icon for entries in the new tab menu for "action" and "profile" type entries. ## References and Relevant Issues This PR is in response to #18103 ## Detailed Description of the Pull Request / Additional comments It is now possible to specify an optional "icon" setting for any "action" or "profile" type entry in the "newTabMenu" JSON settings. When specified, this icon will be used as the menu icon for that action/profile in the new tab menu. If not specified, the action/profile definition's default icon will be used instead (if present). The Cascadia settings schema ("doc/cascadia/profiles.schema.json") has been updated to reflect this. ## Validation Steps Performed Manually tested with multiple combinations of icon settings: - ActionEntry: - valid path in action definition and new tab entry (renders new tab entry icon) - valid path in action definition but no path in new tab entry (renders action definition icon) - no path in action definition, valid path in new tab entry (renders new tab entry icon) - invalid path in action definition, valid path in new tab entry (renders new tab entry icon) - valid path in action definition, invalid path in new tab entry (renders no icon) - invalid path in both (renders no icon) - no path in both (renders no icon) - ProfileEntry: - valid path in new tab entry (renders new tab entry icon) - no path in new tab entry (renders profile's default icon) - invalid path in new tab entry (renders no icon) ## PR Checklist - [x] Closes #18103 - [x] Tests added/passed - [x] Documentation updated - If checked, please file a pull request on [our docs repo](https://github.com/MicrosoftDocs/terminal) and link it here: [#808](https://github.com/MicrosoftDocs/terminal/pull/808) - [x] Schema updated (if necessary)
claunia added the pull-request label 2026-01-31 09:47:24 +00:00
Sign in to join this conversation.
No Label pull-request
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/terminal#31452