# 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](/personalization-data-management/variables-data-enrichment.md) for richer personalization.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.blings.io/personalization-data-management/url-parameters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.