Skip to main content
Deploy the extension to managed Macs with a single .mobileconfig profile. It handles force-install and managed storage for Chrome, Firefox, Vivaldi, and Brave.

​
Generate your profile

Enter your ingest key (from the Velatir dashboard, under your organisation’s settings). The same key is used for every browser. The profile is built locally in your browser, ready to upload to your MDM.

​
Upload to your MDM

  1. In Jamf Pro, go to Computers > Configuration Profiles > Upload.
  2. Upload the generated .mobileconfig file.
  3. Scope it to your target computers and save.
Any MDM that supports .mobileconfig files (Intune, Kandji, Mosyle, and others) follows the same upload-and-scope flow.
The Firefox payload sets EnterprisePoliciesEnabled to true. Without it, Firefox ignores all enterprise policy on macOS.
Edge and ChatGPT Atlas are not in this profile: managed configuration is not reliably delivered to their extensions on macOS, so the profile cannot pass them the ingest key. To use the extension there, install it from the browser’s extension store and enter your ingest key from the popup.

​
Inspect the profile

The profile is plain XML; the generator only substitutes your ingest key into the apiToken fields. To review it before deploying, click Copy profile XML above, or expand the reference template below (with a placeholder for your key).
velatir-browser-extension.mobileconfig
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>PayloadContent</key>
    <array>
        <!-- Chrome: Force install -->
        <dict>
            <key>PayloadType</key>
            <string>com.google.Chrome</string>
            <key>PayloadIdentifier</key>
            <string>com.velatir.chrome.forcelist</string>
            <key>PayloadUUID</key>
            <string>5ECD8344-941A-45C0-BE37-7E13BCBBBBBE</string>
            <key>PayloadVersion</key>
            <integer>1</integer>
            <key>ExtensionInstallForcelist</key>
            <array>
                <string>bbiokppljpbjgiogcoggjnfffbeiihja;https://clients2.google.com/service/update2/crx</string>
            </array>
        </dict>
        <!-- Chrome: Extension managed storage -->
        <dict>
            <key>PayloadType</key>
            <string>com.google.Chrome.extensions.bbiokppljpbjgiogcoggjnfffbeiihja</string>
            <key>PayloadIdentifier</key>
            <string>com.velatir.chrome.extension.config</string>
            <key>PayloadUUID</key>
            <string>5102578B-1554-4556-B895-591A7621A7F8</string>
            <key>PayloadVersion</key>
            <integer>1</integer>
            <key>apiToken</key>
            <string>vltr_yourIngestKeyHere</string>
        </dict>
        <!-- Firefox: Force install + managed storage + enterprise policies -->
        <dict>
            <key>PayloadType</key>
            <string>org.mozilla.firefox</string>
            <key>PayloadIdentifier</key>
            <string>com.velatir.firefox.config</string>
            <key>PayloadUUID</key>
            <string>8B2A4F6E-3D5C-4A1B-9E7F-2C6D8A0B4E1C</string>
            <key>PayloadVersion</key>
            <integer>1</integer>
            <key>EnterprisePoliciesEnabled</key>
            <true/>
            <key>ExtensionSettings</key>
            <dict>
                <key>velatir@velatir.com</key>
                <dict>
                    <key>installation_mode</key>
                    <string>force_installed</string>
                    <key>install_url</key>
                    <string>https://addons.mozilla.org/firefox/downloads/latest/velatir/latest.xpi</string>
                </dict>
            </dict>
            <key>3rdparty</key>
            <dict>
                <key>Extensions</key>
                <dict>
                    <key>velatir@velatir.com</key>
                    <dict>
                        <key>apiToken</key>
                        <string>vltr_yourIngestKeyHere</string>
                    </dict>
                </dict>
            </dict>
        </dict>
        <!-- Vivaldi: Force install -->
        <dict>
            <key>PayloadType</key>
            <string>com.vivaldi.Vivaldi</string>
            <key>PayloadIdentifier</key>
            <string>com.velatir.vivaldi.forcelist</string>
            <key>PayloadUUID</key>
            <string>A1F0C4D2-9B3E-4C7A-8F5D-2E8B1C4A6D90</string>
            <key>PayloadVersion</key>
            <integer>1</integer>
            <key>ExtensionInstallForcelist</key>
            <array>
                <string>bbiokppljpbjgiogcoggjnfffbeiihja;https://clients2.google.com/service/update2/crx</string>
            </array>
        </dict>
        <!-- Vivaldi: Extension managed storage -->
        <dict>
            <key>PayloadType</key>
            <string>com.vivaldi.Vivaldi.extensions.bbiokppljpbjgiogcoggjnfffbeiihja</string>
            <key>PayloadIdentifier</key>
            <string>com.velatir.vivaldi.extension.config</string>
            <key>PayloadUUID</key>
            <string>B2E1D5C3-AC4F-4D8B-9061-3F9C2D5B7E01</string>
            <key>PayloadVersion</key>
            <integer>1</integer>
            <key>apiToken</key>
            <string>vltr_yourIngestKeyHere</string>
        </dict>
        <!-- Brave: Force install -->
        <dict>
            <key>PayloadType</key>
            <string>com.brave.Browser</string>
            <key>PayloadIdentifier</key>
            <string>com.velatir.brave.forcelist</string>
            <key>PayloadUUID</key>
            <string>C3D2E6F4-BD5A-4E9C-A172-4A0D3E6C8F12</string>
            <key>PayloadVersion</key>
            <integer>1</integer>
            <key>ExtensionInstallForcelist</key>
            <array>
                <string>bbiokppljpbjgiogcoggjnfffbeiihja;https://clients2.google.com/service/update2/crx</string>
            </array>
        </dict>
        <!-- Brave: Extension managed storage -->
        <dict>
            <key>PayloadType</key>
            <string>com.brave.Browser.extensions.bbiokppljpbjgiogcoggjnfffbeiihja</string>
            <key>PayloadIdentifier</key>
            <string>com.velatir.brave.extension.config</string>
            <key>PayloadUUID</key>
            <string>D4E3F7A5-CE6B-4F0D-B283-5B1E4F7D9023</string>
            <key>PayloadVersion</key>
            <integer>1</integer>
            <key>apiToken</key>
            <string>vltr_yourIngestKeyHere</string>
        </dict>
    </array>
    <key>PayloadDisplayName</key>
    <string>Velatir Browser Extension</string>
    <key>PayloadIdentifier</key>
    <string>com.velatir.browser.profile</string>
    <key>PayloadType</key>
    <string>Configuration</string>
    <key>PayloadUUID</key>
    <string>D582F777-FEBE-4B67-A3DC-35FD07F37E03</string>
    <key>PayloadVersion</key>
    <integer>1</integer>
</dict>
</plist>

Verify the deployment

Confirm the profile applied and the extension is installed

Enterprise overview

Browser support, managed config, and other platforms