Skip to content

Document PowerToys Text Expander - #6173

Open
Gary Hsu (howdygary) wants to merge 3 commits into
MicrosoftDocs:docsfrom
howdygary:howdygary-powertoys-text-expander-docs
Open

Gary Hsu (howdygary) wants to merge 3 commits into
MicrosoftDocs:docsfrom
howdygary:howdygary-powertoys-text-expander-docs

Conversation

@howdygary

@howdygary Gary Hsu (howdygary) commented Oct 22, 2026 •

Copy link
Copy Markdown

Summary

  • Add user-facing documentation for PowerToys Text Expander: enabling it, managing snippets in the separate snippet editor (search, edit, duplicate, delete), creating snippets, the Insert variable menu and variables, and questions asked when a snippet runs.
  • Document the Advanced settings in PowerToys Settings: matching options, the insertion method, clipboard restore, typing ahead, and undo.
  • Document the JSON snippets database (PowerToysTextExpanderSnippets.json): starter snippets, editing it in a text editor, load errors, and using snippets on several PCs with Move snippets database and Sync from another PC.
  • Cover privacy and limitations: the sensitive-info warning, elevated apps and password boxes, input method editors, running PowerToys as administrator, apps that block pasting, and the ConfigureEnabledUtilityTextExpander Group Policy.
  • Add Text Expander to the PowerToys table of contents.

Related implementation

The implementation PR is still under review. This documentation does not claim that Text Expander has shipped or associate it with a release. The page follows the design in that PR as of its head commit 4a569d1: labels and behavior were checked against its UI strings and code.

Validation

  • LF line endings, final newline, no trailing whitespace, ASCII-only text, and consistent table column counts
  • Front matter, local include target, TOC target, and relative link targets (keyboard-manager.md, administrator.md, grouppolicy.md#configure-enabled-state-for-individual-utilities)
  • Verified the linked .NET custom date and time format reference resolves
  • Learn build validation passed for commit f8db679

This repository does not provide an applicable local Markdown, link, or metadata validation command.

Screenshots

No screenshots are included. The page is complete without them, and this avoids stale implementation images and any private snippet or path data.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@prmerger-automator

Copy link
Copy Markdown
Contributor

Gary Hsu (@howdygary) : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@prmerger-automator

Copy link
Copy Markdown
Contributor

Gary Hsu (@howdygary) : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 8edc69c:

✅ Validation status: passed

File Status Preview URL Details
hub/powertoys/text-expander.md ✅Succeeded
hub/powertoys/toc.yml ✅Succeeded

For more details, please refer to the build report.

@prmerger-automator

Copy link
Copy Markdown
Contributor

PRMerger Results

Issue Description
Added File(s) This PR contains added files. New files require human review.
Yaml File(s) This PR includes changes to .yml file(s) owned by another author.
File Change Percent This PR contains file(s) with more than 30% file change.
…tabase

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 40416d9:

✅ Validation status: passed

File Status Preview URL Details
hub/powertoys/text-expander.md ✅Succeeded
hub/powertoys/toc.yml ✅Succeeded

For more details, please refer to the build report.

@prmerger-automator

Copy link
Copy Markdown
Contributor

PRMerger Results

Issue Description
Added File(s) This PR contains added files. New files require human review.
Yaml File(s) This PR includes changes to .yml file(s) owned by another author.
File Change Percent This PR contains file(s) with more than 30% file change.
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit f8db679:

✅ Validation status: passed

File Status Preview URL Details
hub/powertoys/text-expander.md ✅Succeeded
hub/powertoys/toc.yml ✅Succeeded

For more details, please refer to the build report.

@prmerger-automator

Copy link
Copy Markdown
Contributor

PRMerger Results

Issue Description
Added File(s) This PR contains added files. New files require human review.
Yaml File(s) This PR includes changes to .yml file(s) owned by another author.
File Change Percent This PR contains file(s) with more than 30% file change.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment