Microsoft Intune
Device configuration

Import Custom and Third-party Partner ADMX Templates in Microsoft Intune - Microsoft Intune | Microsoft Learn

In brief

The article’s wording, formatting, metadata, and references were updated. Instructions now more clearly describe upload limits, ADML pairing, dependency order, RBAC permissions, and possible errors involving Windows.admx.

What Intune admins need to know

Administrators get clearer guidance when importing and managing custom ADMX templates, without a stated required action.

This summary was assembled from the tracked documentation change. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

Import customCustom and third-Third-party partnerPartner ADMX templatesTemplates in Microsoft Intune - Microsoft Intune | Microsoft Learn

You can import custom and third-party/partner ADMX and ADML templates into the Intune admin center. Once imported,After you import them, you can create a device configuration policy usingthat uses these settings, and then assign the policy to your managed devices.

This feature applies to:

Tip

The settings catalog has many settings natively built-built in to Intune, including Google Chrome. For more information, go to:see:

  • Use the settings catalog to configure settings

  • Common tasks you can complete using the Settings Catalog

  • Sign in to the Microsoft Intune admin center with an account that has the Policy and Profile Manager built-in role. For more information on the built-in roles, go to Role-based access control for Microsoft Intune.

    To modify or update an ADMX policy withby using the Not Configured setting, RBAC administrators need the Device configurations > Delete permission. The built-in Policy and Profile Manager role has this permission.

  • This feature is in public preview.

  • There are some limits:

    • A maximum ofYou can upload up to 20 ADMX files can be uploaded.files. Each file must be 1 MB or smaller.
    • For each ADMX file, you can upload only one ADML file can be uploaded.file.
    • Each ADMX file supports one language.
    • Only en-us ADML files are supported.
  • Some ADMX files have dependency prerequisites. Import any dependency ADMX files first. If you upload an ADMX file without the dependency, an error message lists the missing namespace.

    For example, to import Mozilla Firefox ADMX and ADML files, you:

    1. Import the mozilla.admx and mozilla.adml files. Make sureEnsure the status shows Available.
    2. Import the firefox.admx and firefox.adml files.

    If you upload firefox.admx before mozilla.adml, then the import fails.

    To see if your ADMX has a dependency, open the ADMX file in a text editor, go to the policyNamespaces node, and look for using prefix. Any dependencies are listed.

    In the following example, thekerberos.admx file requires the Windows.admx file:

    <policyNamespaces>
      </policyNamespaces>
    

    To remove a dependency prerequisite, delete the associated ADMX file first. Then, delete the dependency prerequisite. In ourthe Mozilla Firefox example, delete firefox.admx and then delete mozilla.admx.

  • Some files might require Windows.admx as a prerequisite. ThisYou must upload this file must be uploaded first. In a future release (no ETA), this namespace will be automatically included and eventually not be required.

    If Windows.admx is required and not uploaded, then you can getmight receive the following error message:

    ADMX file referenced not found NamespaceMissing:Microsoft.Policies.Windows. Please upload it first.

  • Currently, the combo box setting type isn't supported. ADMX files with the combo box setting type fail to import. All other setting types are supported.

  • NotYou can't set all areas of the registry can be setby using custom ADMX. For more information onabout the registry locations thatyou can be used, go touse, see Win32 and Desktop Bridge app ADMX policy Ingestion Overview.

  • ADMX settings that are built into Windows (locatedand located in the C:\Windows\PolicyDefinitions folder)folder are enabled through configuration service providers (CSPs).

    • Don't import these built-in settings if your intent is to configure them. Instead, use the settings catalog or a custom profile.
    • Do import these built-in settings if they're a required parent namespace of another file.

    For a list of the ADMX backed CSP settings, go tosee ADMX-backed policies in Policy CSP.

Download the ADMX templates

  1. Sign in to the Microsoft Intune admin center.

  2. Select Devices > Manage devices > Configuration > Import ADMX tab > Import:

    Screenshot that shows how to add or import custom ADMX and ADML by going to Devices > Configuration profiles > Import ADMX in the Microsoft Intune admin center.

    Or, you can also import from Devices > By platform > Windows > Manage devices > Configuration > Import ADMX tab.

  3. Upload your files:

    • ADMX file: Select the ADMX file you want to upload.
    • ADML file for the default language: Select the ADML file you want to upload. Remember, youYou can add only one language file for each ADMX file you upload. For any other limitations, go tosee What you need to know (in this article).
    • Specify the language of the ADML file: Shows the ADML language of the file you uploaded.
  4. Select Next.

  5. In Review + Create, review your changes. Select Create to import the files.

When the import completes,finishes, your ADMX templates are shownappear in the list. You can also:

  • Select Refresh to see the updated state.
  • See the upload Status.
  1. In Scope tags (optional), assign a tag to filter the profile to specific IT groups, such as US-NC IT Team or JohnGlenn_ITDepartment. For more information about scope tags, see Use role-based access control (RBAC) and scope tags for distributed IT.

    Select Next.

  2. In Assignments, select the user or groups that willto receive your profile. For more information on assigning profiles, see Assign user and device profiles in Intune.

    If you assign the profile is assigned to user groups, thenthe configured ADMX settings apply to any device that the user enrolls,enrolls and signs in to. If you assign the profile is assigned to device groups, thenthe configured ADMX settings apply to any user that signs intoin to that device. This assignment happens if the ADMX setting is a computer configuration (HKEY_LOCAL_MACHINE), or a user configuration (HKEY_CURRENT_USER). With some settings, a computer setting assigned to a user can also affect the experience of other users on that device.

    For more information, see User groups vs. device groups when assigning policies.

    Select Next.

  3. In Review + create, review your settings. When you select Create, you save your changes are saved, and assign the profile is assigned.profile. The policy is also shownappears in the profiles list.

Replace existing ADMX files

If you upload an ADMX file with settings that areyou already imported, then the upload fails.

For example, if you upload a different version of an ADMX file that has the same settings as the original ADMX file, then the upload fails with a namespace error.

To update existing ADMX files that areyou imported, you haveuse the following options:

  • Option 1: Replace the existing ADMX file

    To replace an existing ADMX file with the same settings, you can use the following steps:

    1. Delete any profiles usingthat use the existing ADMX settings.
    2. Delete the original ADMX file you imported.
    3. Import the new ADMX and ADML files.
  • Option 2: Create a new ADMX file

    1. Create another version of the ADMX file with a different namespace than the original ADMX file. We recommend you addAdd a version number in the namespace so the names are different.
    2. Add the new and different settings to this ADMX file.
    3. Import the new ADMX and ADML files.

\ No newline at end of file

Daily Intune.Admin.News

Get daily email updates

Get a concise summary of the latest Microsoft Intune updates delivered straight to your inbox.

Loading the secure signup form…