External ID Sessions

Manage user sessions in the embedded editor with the external-id parameter.

What is External ID?

The external-id parameter creates persistent sessions that:

• Tag all created content (templates, renders, uploads, fonts)
• Maintain user assets across sessions
• Enable API filtering by user

Usage

<embed 
  src="https://app.templated.io/editor?embed=CONFIG_ID&external-id=user-123" 
  width="100%" 
  height="700" 
/>

What Gets Tagged

When a user creates content with an external ID:

Session Persistence

When the same external-id is used again:

• Previous uploads are available
• Custom fonts are loaded
• User can access their templates

API Integration

Fetch content by external ID:

// Get templates for a user
const response = await fetch(
  'https://api.templated.io/v1/templates?external_id=user-123',
  { headers: { 'Authorization': 'Bearer API_KEY' } }
);

Best Practices

Naming Convention:

• user-{userId} — Per-user sessions
• project-{projectId} — Per-project sessions
• client-{clientName} — Agency client sessions

Example Use Cases:

<!-- User-specific -->
&external-id=user-456

<!-- Project-specific -->
&external-id=project-summer-campaign

<!-- Client portal -->
&external-id=client-acme-corp

Combining with Account Templates

Show both user templates AND shared account templates:

&external-id=user-123&include-account-templates=true

Documentation: https://templated.io/docs/embed/url-parameters/

Updated on: 11/01/2026