> For the complete documentation index, see [llms.txt](https://help.blings.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.blings.io/app/personalization-data-management/url-parameters.md).

# URL Parameters

Pass data through URLs to create dynamic, personalized video experiences. URL parameters let you personalize content in real-time without pre-uploading contact lists.

## What Are URL Parameters?

URL parameters are key-value pairs added to the end of a video URL that pass data directly to the video. They allow for instant personalization without requiring data to be uploaded beforehand.

## Basic URL Parameter Structure

### Standard Format

```
https://your-video-url.com/video?parameter=value&parameter2=value2
```

### Example URLs

```
https://app.blings.com/video/abc123?name=John&company=Acme
https://app.blings.com/video/abc123?first_name=Sarah&industry=Technology&budget=50000
https://app.blings.com/video/abc123?email=john@company.com&role=Manager&size=Enterprise
```

## Common URL Parameters

### Personal Information

```
?first_name=John
?last_name=Smith
?email=john.smith@company.com
?phone=+1-555-123-4567
```

### Company Information

```
?company=Acme Corporation
?industry=Technology
?company_size=Enterprise
?job_title=Marketing Director
?department=Marketing
```

### Custom Data

```
?customer_id=12345
?product_interests=analytics,automation
?budget_range=50000-100000
?timeline=3_months
?use_case=lead_generation
```

## Using URL Parameters in Your Videos

### Text Personalization

Insert URL parameter values into your video content:

**Examples:**

* "Hello, {{first\_name}}!" (from `?first_name=John`)
* "Welcome to {{company}}!" (from `?company=Acme`)
* "As a {{job\_title}}, you'll love..." (from `?job_title=Manager`)

### Conditional Content

Show different content based on URL parameters:

**Examples:**

* `{{if company_size = "Enterprise"}}Enterprise features{{else}}Standard features{{/if}}`
* `{{if industry = "Healthcare"}}HIPAA-compliant solutions{{else}}Standard security{{/if}}`
* `{{if budget_range = "50000-100000"}}Premium package{{else}}Basic package{{/if}}`

### Dynamic CTAs

Customize call-to-action buttons:

**Examples:**

* "Schedule a demo for {{company}}" (from `?company=Acme`)
* "Get {{personalized\_offer}} now" (from `?personalized_offer=20% discount`)
* "Contact {{sales\_rep}}" (from `?sales_rep=Sarah Johnson`)

## Real-World Examples

### Sales Outreach

```
https://app.blings.com/video/abc123?first_name=John&company=Acme&industry=Technology&budget=75000&sales_rep=Sarah

Video content:
"Hi {{first_name}}! I noticed {{company}} is in the {{industry}} space.

Given your {{budget}} budget, I think you'd be perfect for our Enterprise plan.

{{sales_rep}} from our team would love to show you how we can help."
```

### Product Demo

```
https://app.blings.com/video/def456?name=Mike&role=CTO&company_size=Startup&use_case=scaling

Video content:
"{{name}}, as a {{role}} at a {{company_size}} company, I know you're focused on {{use_case}}.

Let me show you how our platform can help you scale efficiently..."
```

### Event Invitation

```
https://app.blings.com/video/ghi789?first_name=Lisa&industry=Finance&location=New York&event_date=March 15

Video content:
"{{first_name}}, we're hosting a {{industry}} summit in {{location}} on {{event_date}}.

As a leader in the {{industry}} space, we'd love to have you join us..."
```

## Best Practices

### URL Structure

* **Keep it clean** — Use simple, descriptive parameter names
* **Encode special characters** — Use URL encoding for spaces and special characters
* **Limit parameter count** — Too many parameters can make URLs unwieldy
* **Use consistent naming** — Follow a standard format across all URLs

### Data Handling

* **Validate parameters** — Check for required parameters and valid formats
* **Provide fallbacks** — Have default values for missing parameters
* **Sanitize input** — Clean and validate all parameter data
* **Handle errors gracefully** — Show appropriate content for invalid parameters

### Security Considerations

* **Don't include sensitive data** — Avoid passwords, API keys, or personal identifiers
* **Use HTTPS** — Always use secure URLs for parameter passing
* **Validate on server side** — Don't trust client-side parameter validation
* **Log parameter usage** — Track which parameters are being used

## Advanced URL Parameter Features

### Multiple Values

Pass arrays or multiple values:

```
?interests=analytics,automation,reporting
?products=product1,product2,product3
?features=feature1&features=feature2&features=feature3
```

### Encoded Values

Handle special characters and spaces:

```
?company=Acme%20Corporation (space encoded as %20)
?name=Jos%C3%A9 (accented character encoded)
?message=Hello%20World (multiple spaces encoded)
```

### Dynamic URL Generation

Create URLs programmatically:

**JavaScript Example:**

```javascript
const params = new URLSearchParams({
  first_name: 'John',
  company: 'Acme',
  industry: 'Technology'
});
const url = `https://app.blings.com/video/abc123?${params}`;
```

## Integration Examples

### CRM Integration

Generate personalized URLs from your CRM:

```
https://app.blings.com/video/abc123?first_name={{contact.first_name}}&company={{contact.company}}&industry={{contact.industry}}
```

### Email Marketing

Include personalized video links in emails:

```
"Hi {{first_name}}, check out this personalized demo: https://app.blings.com/video/abc123?name={{first_name}}&company={{company}}"
```

### Website Integration

Pass visitor data to videos:

```
https://app.blings.com/video/abc123?referrer=website&page=product&interest={{current_product}}
```

## Common Use Cases

* **Sales outreach and demos**
* **Email marketing campaigns**
* **Website personalization**
* **Event invitations**
* **Product recommendations**
* **Customer onboarding**
* **Lead nurturing**

***

**Want to combine multiple data sources?** Learn about [variables and data enrichment](/app/personalization-data-management/variables-data-enrichment.md) for richer personalization.