Skip to main content

System variables

Some settings available in the GravityZone console require specifying the path on target computers.

To ensure compatibility across different systems, it is recommended to use system variables where applicable.

This article lists the predefined system variables available for use on Windows and macOS. System variables are not supported on Linux.

Note

  • System variables are not supported for paths in Integrity monitoring rules.

  • Some system variables are not supported for exclusions in Configuration profiles or in the Antimalware policy module, as noted below.

  • In addition to system variables, GravityZone supports predefined locations when configuring:

Windows

  • %windir%

    Alias for the Windows directory or system root.

    Typical path:

    C:\Windows

    Example:

    %windir%\Temp

  • %system%

    System32 folder.

    Typical path:

    C:\Windows\system32

    Example:

    %system%\drivers\etc\hosts

  • %system(x86)%

    System32 equivalent for 32-bit binaries on 64-bit systems.

    Typical path:

    C:\Windows\SysWOW64

    Example:

    %system(x86)%\drivers\etc\hosts

    Note

    This variable is not supported for exclusions in configuration profiles or in the Antimalware policy module.

  • %programfiles%

    Program Files folder for 64-bit applications.

    Typical path:

    C:\Program Files

    Example:

    %programfiles%\Adobe\Adobe Creative Cloud

  • %programfiles(x86)%

    Program Files folder for 32-bit applications (on 64-bit systems).

    Typical path:

    C:\Program Files (x86)

    Example:

    %programfiles(x86)%\Common Files

  • %commonprogramfiles%

    Shared files for 64-bit applications.

    Typical path:

    C:\Program Files\Common Files

    Example:

    %commonprogramfiles%\Microsoft Shared

  • %commonprogramfiles(x86)%

    Shared files for 32-bit applications.

    Typical path:

    C:\Program Files (x86)\Common Files

    Example:

    %commonprogramfiles(x86)%\Adobe

  • %commonappdata%

    Application data shared among all users.

    Typical path:

    C:\ProgramData

    Example:

    %programdata%\MyApplication\Logs

    Note

    This variable is not supported for exclusions in configuration profiles or in the Antimalware policy module.

  • %programdata%

    Application data shared among all users.

    Typical path:

    C:\ProgramData

    Example:

    %programdata%\MyApplication\Logs

  • %allusersprofile%

    Alias for the All Users profile folder.

    Typical path:

    C:\ProgramData

    Example:

    %allusersprofile%\Microsoft\Windows\Start Menu

  • %commondocuments%

    Shared Documents folder across all users.

    Typical path:

    C:\Users\Public\Documents

    Example:

    %commondocuments%\logs

    Note

    This variable is not supported for exclusions in configuration profiles or in the Antimalware policy module.

  • %commondesktop%

    Shared Desktop folder across all users.

    Typical path:

    C:\Users\Public\Desktop

    Example:

    %commondesktop%\help.exe

    Note

    This variable is not supported for exclusions in configuration profiles or in the Antimalware policy module.

  • %commonmusic%

    Shared Music folder across all users.

    Typical path:

    C:\Users\Public\Music

    Example:

    %commonmusic%\soundtrack.mp3

    Note

    This variable is not supported for exclusions in configuration profiles or in the Antimalware policy module.

  • %commonvideo%

    Shared Videos folder across all users.

    Typical path:

    C:\Users\Public\Videos

    Example:

    %commonvideo%\intro.mp4

    Note

    This variable is not supported for exclusions in configuration profiles or in the Antimalware policy module.

  • %commonpictures%

    Shared Pictures folder across all users.

    Typical path:

    C:\Users\Public\Pictures

    Example:

    %commonpictures%\wallpaper.jpg

    Note

    This variable is not supported for exclusions in configuration profiles or in the Antimalware policy module.

  • %userprofile%

    Root directory of the current user’s profile.

    Typical path:

    C:\Users\{username}

    Example:

    %userprofile%\Downloads

  • %appdata%

    Roaming AppData folder for the current user.

    Typical path:

    C:\Users\{username}\AppData\Roaming

    Example:

    %appdata%\Mozilla\Firefox

  • %localappdata%

    Local (non-roaming) AppData folder for the user.

    Typical path:

    C:\Users\{username}\AppData\Local

    Example:

    %localappdata%\Temp

  • %mydocuments%

    User's personal Documents folder.

    Typical path:

    C:\Users\{username}\Documents

    Example:

    %mydocuments%\policy.json

    Note

    This variable is not supported for exclusions in configuration profiles or in the Antimalware policy module.

  • %desktop%

    User's Desktop folder.

    Typical path:

    C:\Users\{username}\Desktop

    Example:

    %desktop%\installer.exe

    Note

    This variable is not supported for exclusions in configuration profiles or in the Antimalware policy module.

  • %mymusic%

    User's Music folder.

    Typical path:

    C:\Users\{username}\Music

    Example:

    %mymusic%\song.mp3

    Note

    This variable is not supported for exclusions in configuration profiles or in the Antimalware policy module.

  • %myvideo%

    User's Videos folder.

    Typical path:

    C:\Users\{username}\Videos

    Example:

    %myvideo%\demo.mp4

    Note

    This variable is not supported for exclusions in configuration profiles or in the Antimalware policy module.

  • %mypictures%

    User's Pictures folder.

    Typical path:

    C:\Users\{username}\Pictures

    Example:

    %mypictures%\screenshot.jpg

    Note

    This variable is not supported for exclusions in configuration profiles or in the Antimalware policy module.

  • %systemdrive%

    Drive letter of the volume where Windows is installed.

    The typical drive letter is C:.

    Example:

    %systemdrive%\Installers\application.exe

macOS

  • $HOME

    User profile folder.

    Typical path:

    /Users/{username}

    Example:

    $HOME/Documents/scripts/utilities

  • ~

    User profile folder.

    Typical path:

    /Users/{username}

    Example:

    ~/Downloads/installers

    Note

    $HOME and ~ are equivalent on macOS and can be used interchangeably.

In this section: