Skip to main content
Workspace Settings lets you configure workspace-specific options like name, timezone, tracking script, API keys, and connected integrations.

​
What It Does

Configure Workspace:
  • Workspace name and details
  • Timezone for reporting
  • Tracking script installation
  • API keys for server-side tracking
  • Integration connections
  • Team member access
  • Data retention settings

​
Accessing Workspace Settings

Go to: Dashboard → [Select Workspace] → Settings Each workspace has its own settings.

​
General Settings

​
Workspace Name

Default: Website domain (e.g., “example.com”) Update: 
1. Settings → General
2. Edit "Workspace Name"
3. Save
Workspace name appears in:
  • Workspace selector dropdown
  • Dashboard header
  • Email notifications
  • Team invitations

​
Workspace ID

Public ID: Used in tracking script and API calls Format: Random alphanumeric string (e.g., “abc123xyz”) Cannot be changed after creation. Used for:
  • Tracking script (data-workspace-id="abc123xyz")
  • API authentication
  • Integration webhooks

​
Timezone

Purpose: All timestamps displayed in this timezone Default: America/Chicago Update: 
1. Settings → General → Timezone
2. Select from dropdown
3. Save
Affects:
  • Dashboard date ranges
  • Report timestamps
  • Event Stream times
  • Export timestamps
  • “Today” in date filters
Important: Does not affect stored data (always UTC), only display.

​
Tracking Script

​
Installation Code

Script Displayed: 
<script defer src="https://track.datalyr.com/dl.js"
  data-workspace-id="abc123xyz">
</script>
Copy Button: One-click copy to clipboard Install:
  • Paste in <head> tag of website
  • Before closing </head>
  • On all pages you want to track

​
Verify Installation

Steps: 
1. Install script on site
2. Visit your site
3. Go to Dashboard → Event Stream
4. Verify pageview appears within seconds
Green checkmark appears once first event tracked.

​
API Keys

​
Server-Side Tracking

API Key Displayed: 
api_abc123xyz456789...
Use Cases:
  • Server-side event tracking
  • Backend integrations
  • Mobile app tracking
  • Webhook processing
Keep Secret: Do not expose in client-side code.

​
Regenerating Keys

Steps: 
1. Settings → API Keys
2. Click "Regenerate"
3. Confirm regeneration
4. Update all server-side code
Warning: Old key stops working immediately.

​
Integrations

​
Connected Services

View All: 
Settings → Integrations
Shows:
  • Meta Ads (connected/disconnected)
  • Google Ads (connected/disconnected)
  • TikTok Ads (connected/disconnected)
  • Shopify (connected/disconnected)
  • Stripe (connected/disconnected)
Per Integration:
  • Connection status
  • Last sync time
  • Account details
  • Configure or disconnect

​
Connecting Integrations

Steps: 
1. Settings → Integrations
2. Find platform to connect
3. Click "Connect"
4. Authorize in platform
5. Configure settings
See specific integration guides for details.

​
Disconnecting Integrations

Steps: 
1. Settings → Integrations
2. Find connected platform
3. Click "Disconnect"
4. Confirm
What Happens:
  • Stops syncing new data
  • Historical data retained
  • Can reconnect anytime

​
Team Management

Manage Team: 
Settings → Team
Actions:
  • Invite new members
  • Change member roles
  • Remove members
  • View pending invitations
See Team Management for full details.

​
Data & Privacy

​
Data Retention

Default: Data stored indefinitely Custom Retention:
  • Enterprise plans only
  • Set retention period (e.g., 1 year)
  • Automatic deletion after period
  • Compliance with GDPR/CCPA
Contact [email protected] to configure custom retention.

​
Privacy Settings

Cookie Consent:
  • Enable cookie consent banner
  • Block tracking until consent
  • Compliance with GDPR/CCPA
IP Anonymization:
  • Hash IP addresses
  • Store hashed version only
  • Enhanced privacy
Do Not Track:
  • Respect DNT browser setting
  • Skip tracking for DNT users

​
Advanced Settings

​
Custom Domain

Enterprise Only: Use your own domain for tracking Example: 
Standard: https://track.datalyr.com/dl.js
Custom: https://analytics.yourdomain.com/dl.js
Benefits:
  • Avoid ad blockers
  • Increase tracking reliability
  • Brand consistency
Contact [email protected] to set up.

​
Subdomain Tracking

Enable: 
Settings → Advanced → Cross-Domain Tracking
Toggle: "Include Subdomains"
How It Works:
  • Sets cookies on root domain (.example.com)
  • Tracks across all subdomains automatically
  • No URL parameter needed
Example: 
www.example.com → Visitor ID: anon_abc123
app.example.com → Same visitor ID: anon_abc123
blog.example.com → Same visitor ID: anon_abc123
See Cross-Domain Tracking.

​
Cross-Domain Tracking

Enable: 
Settings → Advanced → Cross-Domain Tracking
Add domains to whitelist
How It Works:
  • Pass visitor ID via URL parameter
  • Links visitors across domains
  • Maintains attribution
Example: 
marketing-site.com → clicks → shop.com
Visitor tracked across both domains

​
Workspace Deletion

Delete Workspace: 
Settings → Advanced → Danger Zone
Click "Delete Workspace"
Confirm deletion
Warning:
  • Permanently deletes all data
  • Cannot be undone
  • Removes from all team members
  • Stops all tracking immediately
Backup first: Export data before deleting.

​
Multiple Workspaces

Switch Workspaces:
  • Dropdown in top nav
  • Shows all workspaces you have access to
  • Click to switch
Use Cases:
  • Separate production and staging
  • Different brands
  • Client accounts (agencies)
  • Geographic regions
Best Practices:
  • Name workspaces clearly
  • Use consistent timezone within organization
  • Share team access appropriately

​
Next Steps

Team Management

Invite and manage team

Integrations Overview

Connect platforms

Installation Guide

Install tracking

Cross-Domain Tracking

Track across domains