{"id":215,"date":"2026-07-21T09:00:03","date_gmt":"2026-07-21T16:00:03","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/insidemsix\/?p=215"},"modified":"2026-07-20T11:56:00","modified_gmt":"2026-07-20T18:56:00","slug":"msix-displayname-vs-package-identity","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/insidemsix\/msix-displayname-vs-package-identity\/","title":{"rendered":"Display Name is for Humans"},"content":{"rendered":"

Package identity<\/a> exists for one primary purpose:<\/p>\n

To provide software with a stable and unambiguous way to identify a package.\n<\/code><\/pre>\n
This is a considerable improvement over the historical tendency to assign UUIDs<\/a> and GUIDs to nearly everything – including things that humans were expected to discuss in meetings.<\/p>\n
Identity Is for Systems<\/h2>\n
A package’s Name<\/strong>, Package Full Name<\/a>, and other identity-derived values are intended for developer and system use.<\/p>\n
These identifiers prioritize correctness, uniqueness, and programmatic consumption – not clarity or friendliness from an end-user’s perspective.<\/p>\n
Identity must remain stable across servicing operations and dependency resolution. If it changes, the system quite reasonably concludes that it is no longer the same package.<\/p>\n
DisplayName Is for Humans<\/h2>\n
That’s where DisplayName<\/code> comes in.<\/p>\n
People use a package’s display name. You’ll typically see it in Start, Settings, installation experiences, and runtime surfaces.<\/p>\n
<Package>\n  <Identity Name=\"Contoso.Parts\"\n            Publisher=\"CN=Contoso LLC, O=Contoso LLC, L=Paris, C=France\"\n            Version=\"1.2.3.4\"\n            ProcessorArchitecture=\"x64\" \/>\n  <Properties>\n    <DisplayName>Contoso Parts 2026<\/DisplayName>\n    ...\n<\/code><\/pre>\n
Unlike package identity fields, which must remain stable for deployment, runtime and servicing, a display name is free to evolve for branding, marketing, or usability reasons.<\/p>\n
Identity tells the system what the package is<\/strong>.<\/p>\n
The display name tells the user what it’s called<\/strong>.<\/p>\n
Localization varies for the same product. As a result, localized values make poor programmatic identifiers. In addition, branding changes usually affect the display name, not the package identity. The package remains the same package even if marketing decides to call it something else.<\/p>\n
Localization<\/h2>\n
Users speak many languages, so hard-coding a single human-readable string would be somewhat limiting.<\/p>\n
To support localization, the value of <\/a> may be prefixed with ms-resource:<\/code>. The runtime resolves the value to a localized string for the user’s language and region.<\/p>\n
<DisplayName>ms-resource:PackageDisplayName<\/DisplayName>\n<\/code><\/pre>\n
Developers can then provide the referenced as multiple language-specific values in the package.<\/p>\n
Users may see different strings based on their localization context – all without altering the package’s underlying identity.<\/p>\n
TL;DR<\/h2>\n
    \n
  • Package identity is for machines<\/strong><\/li>\n
  • Display name is for humans<\/strong><\/li>\n<\/ul>\n
    Confusing the two tends to make at least one of them unhappy – and occasionally both.<\/p>\n","protected":false},"excerpt":{"rendered":"
    Package identity exists for one primary purpose: To provide software with a stable and unambiguous way to identify a package. This is a considerable improvement over the historical tendency to assign UUIDs and GUIDs to nearly everything – including things that humans were expected to discuss in meetings. Identity Is for Systems A package’s Name, […]<\/p>\n","protected":false},"author":911,"featured_media":81,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[8,9,11,19,2,10],"class_list":["post-215","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-msix","tag-architecture","tag-code","tag-identity","tag-localization","tag-msix","tag-terminology"],"acf":[],"blog_post_summary":"
    Package identity exists for one primary purpose: To provide software with a stable and unambiguous way to identify a package. This is a considerable improvement over the historical tendency to assign UUIDs and GUIDs to nearly everything – including things that humans were expected to discuss in meetings. Identity Is for Systems A package’s Name, […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/insidemsix\/wp-json\/wp\/v2\/posts\/215","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/insidemsix\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/insidemsix\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/insidemsix\/wp-json\/wp\/v2\/users\/911"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/insidemsix\/wp-json\/wp\/v2\/comments?post=215"}],"version-history":[{"count":1,"href":"https:\/\/devblogs.microsoft.com\/insidemsix\/wp-json\/wp\/v2\/posts\/215\/revisions"}],"predecessor-version":[{"id":224,"href":"https:\/\/devblogs.microsoft.com\/insidemsix\/wp-json\/wp\/v2\/posts\/215\/revisions\/224"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/insidemsix\/wp-json\/wp\/v2\/media\/81"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/insidemsix\/wp-json\/wp\/v2\/media?parent=215"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/insidemsix\/wp-json\/wp\/v2\/categories?post=215"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/insidemsix\/wp-json\/wp\/v2\/tags?post=215"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}