Unbreakable URLs

Poliage provides two types of permanent URLs:

• Live URLs — Always show the latest approved version (for marketing sites)
• Pinned URLs — Show a specific tagged version (for versioned documentation)

URL Types

Live URL (Always Latest)

https://cdn.poliage.com/v1/assets/[project-id]/[visual-key]

This URL always serves the latest approved version. When you approve a new version, the URL automatically serves the new content.

Use for: Marketing sites, blog posts, landing pages

Pinned URL (Specific Version)

https://cdn.poliage.com/v1/assets/[project-id]/[visual-key]?tag=v1.2

This URL is pinned to a specific version tag. Even when you publish new versions, this URL continues to serve the tagged version.

Use for: Versioned documentation, release notes, archived docs

Tagging Versions

When publishing, use the --tag flag to create a pinned version:

poliage publish --tag v1.2

This creates a snapshot that can be referenced forever:

<!-- For v1.2 docs -->
 
![Login](https://cdn.poliage.com/v1/assets/proj_123/login?tag=v1.2)

The Pointer Pattern

Unbreakable URLs are permanent links that act as "pointers." They never change, but the image they display updates automatically when you approve a new version.

URL Structure

Assets are served via our global CDN:

https://cdn.poliage.com/v1/assets/[project-id]/[visual-key]

Example

If you have a visual named "login-modal":

https://cdn.poliage.com/v1/assets/proj_123/login-modal

• Today: Serves the v1.0 login screen
• Tomorrow: You redesign and approve v2.0
• Result: The exact same URL serves the v2.0 image

Your docs are instantly up to date with zero changes.

Embedding in Documentation

Use the permanent URL in your Markdown:

![Login Modal](https://cdn.poliage.com/v1/assets/proj_123/login-modal)

Or in HTML:

<img
  src="https://cdn.poliage.com/v1/assets/proj_123/login-modal"
  alt="Login Modal"
/>

Accessing Variants

If you capture multiple variations (Dark Mode, different languages), access them with query parameters:

Benefits

• No broken links: URLs never change
• Zero maintenance: Approve in dashboard, docs update automatically
• Version control: Roll back anytime
• Variant support: Single URL, multiple contexts