Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.velatir.com/llms.txt

Use this file to discover all available pages before exploring further.

Deploy the Velatir browser extension to managed Macs with a single .mobileconfig profile that handles force-install and managed storage for Chrome, Edge, Firefox, Vivaldi, Brave, and ChatGPT Atlas.

​
Jamf Pro (macOS)

​
Configuration Profile

A single .mobileconfig profile handles force-install and managed storage for Chrome, Edge, Firefox, Vivaldi, Brave, and ChatGPT Atlas. Upload it to Jamf Pro as a Configuration Profile (or any MDM that supports .mobileconfig files).
Replace vltr_yourApiTokenHere with your Velatir API token and Your Organization with your organisation’s display name before deploying.
The Firefox payload sets EnterprisePoliciesEnabled to true. Without it, Firefox ignores all enterprise policy configuration on macOS.
ChatGPT Atlas (macOS-only, by OpenAI) currently supports ExtensionInstallForcelist but does not document support for per-extension managed storage under com.openai.atlas.web.extensions.<id>. The Atlas payload below force-installs the extension; users complete apiToken and organizationName from the extension popup the first time they open it. When OpenAI adds managed-storage support, this profile can be updated to deliver those values automatically. See OpenAI’s ChatGPT Atlas for Enterprise article for the current supported key set.
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_yourApiTokenHere</string>
            <key>organizationName</key>
            <string>Your Organization</string>
        </dict>
        <!-- Edge: Force install + require for InPrivate -->
        <dict>
            <key>PayloadType</key>
            <string>com.microsoft.Edge</string>
            <key>PayloadIdentifier</key>
            <string>com.velatir.edge.forcelist</string>
            <key>PayloadUUID</key>
            <string>590735BD-010D-4C3E-BB5B-0FF9DE7577B8</string>
            <key>PayloadVersion</key>
            <integer>1</integer>
            <key>ExtensionInstallForcelist</key>
            <array>
                <string>phgnjcoglpdamjjmidheehacjbkgkooc;https://edge.microsoft.com/extensionwebstorebase/v1/crx</string>
            </array>
            <key>MandatoryExtensionsForInPrivateNavigation</key>
            <array>
                <string>phgnjcoglpdamjjmidheehacjbkgkooc</string>
            </array>
        </dict>
        <!-- Edge: Extension managed storage -->
        <dict>
            <key>PayloadType</key>
            <string>com.microsoft.Edge.extensions.phgnjcoglpdamjjmidheehacjbkgkooc</string>
            <key>PayloadIdentifier</key>
            <string>com.velatir.edge.extension.config</string>
            <key>PayloadUUID</key>
            <string>963ED0A7-556F-45A6-8F17-A0DBDF3DA264</string>
            <key>PayloadVersion</key>
            <integer>1</integer>
            <key>apiToken</key>
            <string>vltr_yourApiTokenHere</string>
            <key>organizationName</key>
            <string>Your Organization</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>
                    <key>private_browsing</key>
                    <true/>
                </dict>
            </dict>
            <key>3rdparty</key>
            <dict>
                <key>Extensions</key>
                <dict>
                    <key>velatir@velatir.com</key>
                    <dict>
                        <key>apiToken</key>
                        <string>vltr_yourApiTokenHere</string>
                        <key>organizationName</key>
                        <string>Your Organization</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_yourApiTokenHere</string>
            <key>organizationName</key>
            <string>Your Organization</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_yourApiTokenHere</string>
            <key>organizationName</key>
            <string>Your Organization</string>
        </dict>
        <!-- ChatGPT Atlas: Force install. Atlas is macOS-only; OpenAI's
             documented MDM key set includes ExtensionInstallForcelist. Managed
             per-extension storage under com.openai.atlas.web.extensions.<id> is
             not currently documented as supported, so we configure force-install
             only and let users complete the rest from the extension UI. -->
        <dict>
            <key>PayloadType</key>
            <string>com.openai.atlas.web</string>
            <key>PayloadIdentifier</key>
            <string>com.velatir.atlas.forcelist</string>
            <key>PayloadUUID</key>
            <string>E5F4A8B6-DF7C-4A1E-C394-6C2F5A8E0134</string>
            <key>PayloadVersion</key>
            <integer>1</integer>
            <key>ExtensionInstallForcelist</key>
            <array>
                <string>bbiokppljpbjgiogcoggjnfffbeiihja;https://clients2.google.com/service/update2/crx</string>
            </array>
        </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>
  1. In Jamf Pro, go to Computers > Configuration Profiles > Upload
  2. Upload the .mobileconfig file above
  3. Scope the profile to your target computers
  4. Save the configuration profile

Verify the deployment

Confirm the profile applied and the extension is installed

Enterprise overview

Browser support, managed config, and other platforms