Edit

Share via

desktop7:Shortcut

Creates a shortcut to a file.

Element hierarchy

<Package>

    <Applications>

         <Application>

              <Extensions>

                   <desktop7:Extension>

                        <desktop7:Shortcut>

Syntax

<desktop7:Shortcut
    File =  'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    Icon = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    Arguments = 'An optional string with a value between 1 and 256 characters in length.'
    PinToStartMenu = 'A boolean value.'
    ExcludeFromShowInNewInstall = 'A boolean value.'
    Description = 'A string with a value between 1 and 2048 characters in length.'
    desktop10:DisplayName = 'An optional string with a value between 1 and 256 characters in length. This string is localizable.'
    desktop10:Description = 'An optional string with a value between 1 and 2048 characters in length. This string is localizable.' >

    desktop7:AppMigrations?

</desktop7:Shortcut>

Key

? optional (zero or one)

Attributes and elements

Attributes

Attribute Description Data type Required Default value
File The path to the file that is the target of the shortcut. A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *. Yes
Icon The path to the file that is the icon of the shortcut. A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *. Yes
Arguments Arguments to the shortcut. An optional string with a value between 1 and 256 characters in length. No
PinToStartMenu A boolean value specifying if the shortcut is pinned to the Start menu. A boolean value. No
ExcludeFromShowInNewInstall A boolean value specifying if the shortcut should be excluded from the highlighting that is applied to newly installed apps. A boolean value. No
Description The description of the shortcut. A string with a value between 1 and 2048 characters in length. No
desktop10:DisplayName The display name for the shortcut. An optional string with a value between 1 and 256 characters in length. This string is localizable. No
desktop10:Description The localizable description for the shortcut. An optional string with a value between 1 and 2048 characters in length. This string is localizable. No

Child elements

Child element Description
desktop7:AppMigrations Specifies a set of app migration entries for a deactivated shortcut for a recently uninstalled app.

Parent elements

Parent element Description
Extension Defines an extensibility point for the application.

Remarks

The File path format is a path relative to one of the following constants that resolve to a directory.

Constant Directory
Common Programs C:\ProgramData\Microsoft\Windows\Start Menu\Programs
Programs C:\Users<username>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs
Desktop C:\Users<username>\Desktop

So, for example the following value for File creates a shortcut with the path C:\Users\<username>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Subfolder\Shortcut.exe.lnk.

File="$$(Programs)\Subfolder\Shortcut.exe.lnk"

Requirements

Item Value
Namespace http://schemas.microsoft.com/appx/manifest/desktop/windows10/7
desktop10 http://schemas.microsoft.com/appx/manifest/desktop/windows10/10
Minimum OS Version Windows 10 (Build 19645)
  • Last updated on