System properties in offline mode

  • Release version: Australia
  • Updated June 8, 2026
  • 6 minutes to read

    • Use the table to view system properties related to offline mode.

    This page lists all system properties related to offline mode. Refer to the individual offline mode topics to learn how each property influences different aspects of the offline experience and how they can be used to customize user behavior and performance.

    Create system properties to customize the offline mode behavior of the mobile application

    Note:
    Install or request installation of the SG Offline support plugin (com.glide.sg.offline).
    1. Navigate to All > sys_properties.list
    2. Verify that the property does not exist by searching for the property name in the System Properties table.
    3. Select New.
    4. Complete the System Property form using the property names listed in this table. Use the information in the description to determine a value for the property.
    Note:
    For more information on creating system properties, see Mobile system property configurations.

    Topic reference

    Topic Sub-Topic Property Name Description
    Activation and deactivation of offline mode Deactivation glide.sg.offline.enabled Offline mode is enabled by default. To disable offline mode, create a system property with this name and set the value to false.
    Control what data is available in offline Attachments glide.sg.offline.attachment.allowed_content_types A comma-separated list of allowed file types for attachments in offline mode.
    Configuration:
    • Property Type: String
    • Default value: image/png, image/gif, image/jpeg, video/QuickTime
      Note:
      The expected value must be a listed MIME type.
    Control what data is available in offline Attachments in offline glide.sg.offline.attachment.max_size Sets the maximum file size in bytes for attachments downloaded into the offline cache. Attachments that exceed this limit aren't downloaded and display as a placeholder instead.

    Example: To set a limit of 20 MB, enter 20971520.

    Configuration:
    • Property Type: Integer
    • Default value: 50000 (50 MB)
    • Min value: 0
    • Maximum value: 1073741824 (1 GB)
    Control what data is available in offline Attachments in offline glide.sg.offline.attachment.max_total_bytes Defines the total amount of storage the offline cache can use for attachments in bytes.

    Example: To set a total limit of 100 MB, enter 104857600.

    Configuration:
    • Property Type: Integer
    • Default value: 52428800 (50 MB)
    • Min value: 0
    • Maximum value: 2147482548 (2 GB)
    Security & compliance Security glide.sg.offline.roles A comma-separated list of role names that are allowed to work in offline mode. If empty, all users may use offline mode.
    Security & compliance Security glide.sg.offline.expiration

    Defines how long offline cached data remains valid on the device before expiring and being automatically deleted in accordance with security policies. Defaults to 48 hours (2 days).

    Default value: 172800 (The property value is in seconds).
    Control when data is being downloaded for offline usage Incremental updates glide.sg.offline.incremental.enabled

    Enables incremental offline updates for all users. Incremental offline is inactive by default.

    Configuration:
    • Property Type: true | false
    • Default value: false
    Control when data is being downloaded for offline usage Incremental updates glide.sg.offline.incremental.client_polling_interval

    Defines the interval at which the polling mechanism checks the server for missed changes.

    Mobile devices can lose connectivity or enter operating system-level sleep modes that block background network activity, causing watcher events to be missed. When the app returns online or is set to active, the polling mechanism asks the server whether any records have changed since the last successful incremental sync, and if so, triggers an incremental update. This acts as a fallback to verify the device catches up with any updates missed while offline or asleep.

    Configuration:
    • Property type: Integer
    • Property value: Duration in minutes
    • Default value: 1
    • Min value: 0
    Control when data is being downloaded for offline usage Incremental updates glide.sg.offline.incremental.record_watcher_expiration
    Note:
    This setting is applicable only when the glide.sg.offline.incremental.enabled system property is set to true.

    Screens that are marked as available offline are linked to specific data items that determine which records are included for that screen. These records are continuously monitored by a record watcher, which tracks any insert, update, or delete actions. When a change matches the data item filter criteria, the watcher automatically initiates an incremental update to sync the latest data to the user's device.

    This property specifies how long the record watcher remains active when no changes have occurred to trigger an incremental update.

    Configuration:
    • Property Type: Integer
    • Default value: 24 hours
    Control when data is being downloaded for offline usage Incremental updates glide.sg.offline.incremental.silent_push.max_pushes_per_hour
    Note:
    This property specifies how long the defined record watcher remains active when no changes have occurred to trigger an incremental update.
    The number of incremental updates a user can receive in an hour. If more updates occur than this limit allows, the extra changes are deferred to the next hour.

    This property works alongside glide.sg.offline.incremental.silent_push.min_wait_time (default: 1 minute), which enforces a minimum gap between consecutive pushes regardless of the hourly count.

    Configuration:
    • Property Type: Integer
    • Default value: 3
    • Maximum value: 10
    When data is downloaded for offline usage Incremental updates glide.sg.offline.incremental.silent_push.min_wait_time
    Note:
    This setting is applicable only when the glide.sg.offline.incremental.enabled system property is set to true.
    Specifies the minimum interval, in minutes, between consecutive incremental updates sent to the user's device. Even if new updates are available, the app waits for the defined duration before sending the next update.
    Configuration:
    • Property Type: Integer
    • Default value: 1
    • Min value: 1
    • Maximum value: 1440
    Control when data is being downloaded for offline usage Scheduled jobs glide.sg.offline.scheduled_download.enabled Enables scheduled downloading for all mobile app users. Scheduled downloading is inactive by default.
    Configuration:
    • True | False
    • Default value: false
    Control when data is being downloaded for offline usage Scheduled jobs glide.sg.offline.scheduled_download.cachesync_offset Defines the number of minutes before the user's scheduled time that offline payload generation begins. This value offsets the start of generation ahead of the agent's schedule.

    Example: If the agent schedule is set to 10:00 and glide.sg.offline.scheduled_download.cachesync_offset is configured to 30 minutes, offline cache generation starts at 09:30.

    Configuration:
    • Property Type: Integer
    • Default value: 60
    Note:
    This property should not be set to start earlier than the mobile offline scheduling job run time. Setting it earlier than the job execution prevents offline payloads from being generated.
    Control when data is being downloaded for offline usage Scheduled jobs glide.sg.offline.scheduled_download.reminder_offset Define how many minutes before the user's scheduled time the download reminder is sent. The reminder appears only when no cache exists or the existing cache has expired.

    The following two properties work together. glide.sg.offline.scheduled_download.reminder_offset (default: 15 minutes) defines how early the mobile app prompts the agent to download, while glide.sg.offline.scheduled_download.cachesync_offset (default: 60 minutes) defines how early the server pre-builds the cache.

    Configuration:
    • Property Type: Integer
    • Default value: 15
    Control when data is being downloaded for offline usage Scheduled jobs glide.sg.offline_payload.refresh_frequency Defines a fixed interval between the initial scheduled cache download and when the cache should be refreshed. This allows the device to automatically update its cache at a predictable time, ensuring it stays current when connectivity is available. For example, a device can be configured to refresh its cache during a lunch break, so the cache is already current when work resumes.

    Example: If the agent's schedule runs daily at 10:00 and the refresh interval is set to 240 (4 hours), the cache refreshes automatically at 14:00, provided the device has connectivity at that time.

    Configuration:
    • Property Type: Integer
    • Default value: 480 minutes (8 hours)
    Control when data is being downloaded for offline usage Manual download / Scheduled jobs / Incremental updates glide.sg.offline.job.maxRuntime Controls how long the server can spend generating the offline cache payload for a user. If the download does not complete, the user sees an error rather than receiving incomplete or partial data. This applies to both scheduled job and manual downloads.
    Configuration:
    • Property Type: Integer
    • Default value: 600000 ms (10 minutes)
    • Minimum allowed: 5000 ms (5 seconds)
    • Maximum allowed: 1200000 ms (20 minutes)