Edit

Windows Share DataFormat and FileType reference

Use this reference to choose the correct DataFormat declarations and APIs for your Windows Share integration.

DataFormat reference table

DataFormat Send API Receive API Typical app types
Text SetText GetTextAsync Notes apps, clipboard tools, general text
Uri / WebLink SetWebLink GetWebLinkAsync Browsers, bookmarks, messaging apps
ApplicationLink SetApplicationLink GetApplicationLinkAsync Apps that expose deep links
Html SetHtmlFormat GetHtmlFormatAsync Email clients, rich-text editors
Bitmap SetBitmap GetBitmapAsync Photo editors, image viewers
StorageItems SetStorageItems GetStorageItemsAsync File managers, cloud storage apps
Rtf SetRtf GetRtfAsync Word processors, rich-text editors

Tip

For URLs, always prefer SetWebLink over SetText. Target apps can generate rich link previews and handle navigation correctly only when the content arrives typed as a URI.

FileType declarations by app category

Use this cheat sheet to choose the narrowest set of <uap:FileType> declarations for your manifest. Declaring fewer, more specific types reduces noise in the Share Sheet and prevents your app from appearing for content it can't handle.

App category Recommended <uap:FileType> declarations Additional data formats
Photo viewer / editor .jpg .jpeg .png .gif .bmp .heic .webp Bitmap, StorageItems
Video player .mp4 .mov .avi .mkv .wmv StorageItems
Audio player .mp3 .flac .wav .aac .m4a StorageItems
Document editor .pdf .docx .xlsx .pptx .txt StorageItems
Link handler / browser (no file types) Uri, WebLink
Messaging app (no file types, or specific attachment types) Uri, WebLink, StorageItems
Notes app .txt .md Text, StorageItems
Cloud storage / file mover <uap:SupportsAnyFileType /> StorageItems

Important

<uap:SupportsAnyFileType /> is appropriate only for general-purpose file movers. For every other app category, declare specific file extensions. Over-broad declarations are the most common share-target bug.

Related content

  • Last updated on