Technical FAQ

Frequently asked questions about technical features and troubleshooting.

Why is my chart not loading data?

If your chart is not displaying data, try the following:

1. Check your internet connection -- ChartLabs requires an active connection
2. Verify the instrument -- Ensure the selected symbol is valid and supported by your data provider
3. Check market hours -- Some instruments only have data during market hours
4. Refresh the page -- Press Ctrl+Shift+R (or Cmd+Shift+R on Mac) to hard refresh
5. Clear browser cache -- Cached data may occasionally cause display issues

Why is my real-time data delayed?

Real-time data availability depends on your plan and the data provider:

• Free plan -- Delayed data (typically 15-20 minutes)
• Pro plan -- Real-time data for most instruments
• Ultimate plan -- Real-time data with priority streaming

If you are on a paid plan and still seeing delays, check that your WebSocket connection is active (look for the connection indicator in the platform).

How does the WebSocket connection work?

ChartLabs uses WebSocket connections for real-time data streaming. The connection:

• Authenticates automatically using your session token
• Sends periodic heartbeats (every 20 seconds) to keep the connection alive
• Reconnects automatically if the connection drops (up to 3 attempts)
• Streams real-time price ticks, order updates, and alert notifications

If you experience connection issues, refreshing the page will re-establish the WebSocket connection.

What timeframes are available?

ChartLabs supports a wide range of timeframes:

Category	Timeframes
Tick	1 tick
Seconds	1s, 5s, 10s, 15s, 30s
Minutes	1m, 2m, 3m, 5m, 10m, 15m, 30m
Hours	1h, 2h, 4h
Days	1D
Weeks	1W
Months	1M

How do I save my workspace layout?

ChartLabs automatically persists your workspace layout. You can also:

1. Open the Workspaces menu
2. Click Save Workspace
3. Enter a name for your layout
4. The workspace is saved and can be restored at any time

See Workspaces for more details.

Can I use multiple monitors?

Yes. Golden Layout supports popping out individual panels into separate browser windows. Right-click a panel tab and select Pop Out to detach it. This allows you to spread your workspace across multiple monitors.

What is CodeLab?

CodeLab is ChartLabs' built-in script editor for creating custom indicators. It uses TypeScript and the @chartlabs/script-sdk to let you:

• Write custom technical indicators
• Access OHLCV price data and built-in math functions
• Plot lines, histograms, areas, and other visualizations on charts
• Publish indicators to the Marketplace

See the CodeLab section for full documentation.

What programming language does CodeLab use?

CodeLab scripts are written in TypeScript. Each script extends the Script base class from the @chartlabs/script-sdk and implements a main() method that runs on every bar. No external dependencies are needed -- the SDK provides built-in functions for common calculations like SMA, EMA, RSI, standard deviation, and more.

Why is my custom indicator not working?

Common issues with custom indicators:

1. Compilation errors -- Check the script console for TypeScript errors
2. Missing return values -- Ensure main() returns a value or uses this.plot() / this.setPlotValue()
3. Insufficient data -- Some calculations need a minimum number of bars (e.g., SMA(20) needs at least 20 bars)
4. Input declarations -- Verify that @input decorators are correctly defined with valid default values
5. Infinite loops -- Avoid loops that do not terminate; scripts run on every bar update

Use the Script Console panel to view compilation output and runtime logs.

How do I use the Screener?

The Screener lets you scan instruments in real time:

1. Open the Screener panel from the layout menu
2. Use the search bar to filter by name or symbol
3. Apply filters for asset type, exchange, price range, volume, and change
4. Click column headers to sort results
5. Click any instrument to load it on the chart

See Screener Overview for details.

How do alerts work technically?

Alerts are evaluated server-side by the Alert Consolidator service:

1. You create an alert with a condition (e.g., price crosses above 150)
2. The server monitors incoming price ticks against your condition
3. When the condition is met, a notification is triggered
4. Notifications are delivered via your configured channels (sound, popup, email, webhook)

Alerts support 15 different condition operations and 5 trigger frequencies. See Alert Conditions for the full list.

What is tab linking?

Tab linking synchronizes the selected instrument across multiple panels. When panels share the same color-coded link group, changing the instrument in one panel automatically updates all other panels in that group. This is useful for keeping charts, watchlists, order panels, and screeners in sync.

See Tab Linking for details.

How do I reset my workspace?

If your workspace becomes cluttered or broken:

1. Open the Workspaces menu
2. Select a previously saved workspace to restore it
3. Or select the default workspace to reset to the standard layout

What keyboard shortcuts are available?

ChartLabs supports keyboard shortcuts for common actions. See the full list at Keyboard Shortcuts.

How do I report a bug?

If you encounter a bug or unexpected behavior:

1. Note the steps to reproduce the issue
2. Check the browser developer console (F12) for any error messages
3. Contact ChartLabs support with the reproduction steps and any error details
4. Include your browser name/version and operating system