> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datalyr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspace Settings

> Configure workspace name, timezone, tracking, and integrations

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:**

```html theme={null}
<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](/features/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 [hello@datalyr.com](mailto:hello@datalyr.com)** 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 [hello@datalyr.com](mailto:hello@datalyr.com) 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](/understanding-data/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

<CardGroup cols={2}>
  <Card title="Team Management" icon="users" href="/features/team-management">
    Invite and manage team
  </Card>

  <Card title="Integrations Overview" icon="plug" href="/integrations/overview">
    Connect platforms
  </Card>

  <Card title="Installation Guide" icon="code" href="/getting-started/installation/overview">
    Install tracking
  </Card>

  <Card title="Cross-Domain Tracking" icon="arrow-right-arrow-left" href="/understanding-data/cross-domain-tracking">
    Track across domains
  </Card>
</CardGroup>
