Skip to content

Settings

Configure DataGlass behavior in Settings → DataGlass.

Domain Inference

DataGlass detects categorical data patterns and preserves meaningful order instead of sorting alphabetically.

How It Works

When your data contains fields like status with values ["pending", "in-progress", "done"], DataGlass:

  1. Detects this as a categorical sequence
  2. Preserves the order values appear in your data
  3. Displays bars/points in that order on the axis

Without inference, values sort alphabetically: ["done", "in-progress", "pending"]—wrong for a workflow.

Settings

SettingDefaultDescription
enableAutoDomainInferencetrueDetect and preserve category order
domainInferenceThreshold10Max unique values to trigger inference (2-50)
showDomainWarningstrueWarn when inference might be wrong
showInferredDomainInfofalseShow indicator when inference was used

Override Inference

Specify explicit order when inference gets it wrong:

yaml
type: bar
x: priority
y: count
scales:
  x:
    domain: [Critical, High, Medium, Low]

Command

Show Domain Quick Reference - Opens help modal with examples.

Data Quality

SettingDefaultDescription
showDataQualityWarningstrueWarn about missing data points in multi-series

Warns when a category exists in some series but not others, which can cause gaps in grouped charts.

Caching

Data Cache

SettingDefaultDescription
cacheEnabledtrueCache parsed data in memory
cacheMaxSize100Maximum number of cached items
cacheTTL30Cache lifetime in minutes

URL Cache

SettingDefaultDescription
urlCacheEnabledtrueCache URL fetch responses
urlCacheDuration15URL cache lifetime in minutes

URL Data

SettingDefaultDescription
enableUrlDatatrueAllow loading data from URLs
allowInsecureHttpfalsePermit HTTP (not HTTPS) URLs
urlWhitelist[]Allowed URL patterns (supports wildcards)

URL Whitelist

Restrict which URLs can be fetched:

https://api.example.com/*
https://*.github.io/*

Leave empty to allow all URLs.

Performance

SettingDefaultDescription
enablePerformanceMonitoringtrueTrack render times
performanceLogLevel'warn'Console log level ('none', 'warn', 'info', 'debug')

See Performance for monitoring commands.

Rendering

SettingDefaultDescription
defaultEngine'plot'Default rendering engine ('plot' or 'd3')
defaultWidth600Default chart width in pixels
defaultHeight400Default chart height in pixels

Chart Defaults

SettingDefaultDescription
defaultColorScheme'schemeCategory10'Default D3 color palette
defaultLayout'default'Default layout preset

Security

SettingDefaultDescription
maxConfigSize10240Maximum YAML size in bytes
maxInlineJsonSize5120Maximum inline JSON size in bytes
maxDataPoints10000Maximum points per chart
maxChartWidth2000Maximum chart width in pixels
maxChartHeight2000Maximum chart height in pixels
maxConcurrentRequests5Parallel URL fetches
maxRequestsPerMinute20Rate limit for URL fetches

These limits prevent resource exhaustion from malformed or malicious configurations.

Resetting Settings

Click "Restore defaults" at the bottom of the settings panel to reset all options.

Released under the MIT License. Built by Boundary Lab.