What does Windows error code 14096 (ERROR_UNMAPPED_SUBSTITUTION_STRING) mean?

ERROR_UNMAPPED_SUBSTITUTION_STRING

A substitution string had no mapping.

ERROR_UNMAPPED_SUBSTITUTION_STRING is Windows status 14096 (0x00003710) associated with resolution of a syntactically valid substitution token without a mapping.

Likely impact: Leaving a token unresolved can expose placeholders to users or break servicing decisions that depend on the text.

Typical causes

• the mapping entry is absent.
• token spelling or case differs.
• the wrong localization scope is loaded.
• package generation omitted a variable.

Troubleshooting steps

1. Verify that the substitution table defines a value for every token used by the localized resource.
2. Collect token name and source string and available substitution map.
3. Compare the unresolved token with the substitution map for the active locale and package, including the generated mapping file used by the failing build.

Useful evidence

• Collect package or manifest identity.
• Collect build step that generated mappings.

Recovery and retry

Add the authoritative mapping or correct the token name and rebuild the resource package.

Related errors

ERROR_MALFORMED_SUBSTITUTION_STRING fails syntax; this code parses the token but cannot resolve it

Example

A manifest references $(PublisherDisplayName) but the package mapping omits it. Restoring the generated mapping resolves the resource.

References

• Microsoft: exact Win32 system error range
• Microsoft: Assembly manifests
• Microsoft: Side-by-side assemblies