How to develop an OEM app that uses a custom file

For more information on creating and using custom data files, see DISM App Package (.appx or .appxbundle) Servicing Command-Line Options.

Learn how to develop an app that uses a custom file to pass info from the OEM to the app.

For apps that you create for OEM deployment, you can use a custom file to pass info from the OEM to the apps. To pass OEM info to an app, you create a file in the microsoft.system.package.metadata folder. This file name is special to the operating system and is automatically carried forward during operating system updates. OEMs can use this file to pass in custom identifiers, so that apps know when OEMs have deployed them. You can have only one file per app. Apps must be able to look for and read this file correctly. Developers treat the file as untrusted data.

What you need to know




Step 1: Create custom file and add it to the package metadata folder

You can design your app to use any format you choose for the custom data. For example, you can use XML, a text file, or another file type to organize your data. We recommend that you consider how you can test and validate the file. For example, you can create an XML schema to validate an XML file.

You can specify any type of file with any file name for the custom data. When you add the app package with the custom data file by using the DISM tool, DISM renames the custom file to and saves the file to the microsoft.system.package.metadata folder.


The custom data file can't be modified by the app. It's a read-only resource.


Step 2: Access the custom data file for an app

You can access the file for an app from your code by using Windows APIs to get information for the current package. For example:


For more info about developing with the Package.Current property, see Quickstart: Query app package manifest info.

For more info about accessing the file via IStorageFolder.GetFileAsync and by using StorageFile objects, see Accessing data and files.

Quickstart: Query app package manifest info