Brand Assets

Upload and manage your images and videos in a centralized library, then reuse them across all your Stories.

Overview

Brand Assets is your centralized media library for all images and videos used in Stories. Upload once, organize with folders and tags, and reuse across unlimited Stories without re-uploading.

Key benefits:

  • Upload once, use everywhere - Reuse assets across all Stories
  • Smart organization - Folders, tags, and search for quick discovery
  • Usage tracking - See where each asset is used
  • Replace-in-place - Update a file and all Stories using it update automatically

Uploading Assets

  1. Go to Settings > Brand Assets in your dashboard
  2. Click Upload Asset
  3. Drag and drop files into the upload area, or click to browse
  4. Add optional tags to help organize your assets
  5. Click Upload

Supported Formats

Images:

  • PNG, JPG, JPEG, GIF, SVG, WebP
  • Maximum size: 10 MB per file

Videos:

  • MP4, WebM, MOV
  • Maximum size: 50 MB per file

Bulk Upload

You can upload multiple files at once. Drag several files into the upload area or select multiple files when browsing. Each file uploads with its own progress indicator.

Organizing Assets

Folders

Create folders to group related assets:

  1. Click New Folder in the left sidebar
  2. Enter a folder name
  3. Choose an optional color for visual distinction
  4. Drag assets into folders, or use the asset menu to move them

Click a folder in the sidebar to filter the view to only assets in that folder. Click All to see everything, or Unfiled to see assets not in any folder.

Tags

Add tags to assets for flexible categorization:

  1. Click an asset to open its details
  2. Add tags like "logo", "hero", "summer-campaign"
  3. Filter by tag using the dropdown above the asset grid

Assets can have multiple tags, making them easy to find through different searches.

Use the search bar to find assets by name. Search works across all folders and combines with type and tag filters.

Viewing Asset Details

Click any asset to open its detail view, which shows:

  • Preview - Full-size preview of the image or video
  • File info - Name, type, size, dimensions
  • Tags - View and edit tags
  • Usage - See which Stories use this asset

From the detail view, you can rename the asset, update tags, replace the file, or delete it.

Using Assets in Stories

When building a Story in the editor:

  1. Click Add Image in the element toolbar
  2. The asset picker opens showing your library
  3. Search or filter to find the asset you need
  4. Click to select, then click Add to Story

The asset is added to your canvas. You can resize and position it like any other element.

Replacing an Asset File

Update an asset's file while keeping all existing usages:

  1. Click the asset to open its details
  2. Click Replace File
  3. Upload the new file
  4. All Stories using this asset automatically update

This is useful when updating logos or refreshing campaign images without manually editing each Story.

Deleting Assets

Deleting Unused Assets

  1. Click the asset to open its details (or use the ... menu on the asset card)
  2. Click Delete
  3. Confirm the deletion

Deleting Assets in Use

If an asset is used in one or more Stories:

  1. The delete confirmation shows where it's used
  2. You can choose to Force Delete, which removes the asset from all Stories
  3. Or cancel and manually remove the asset from Stories first

Bulk Operations

Manage multiple assets at once:

  1. Click Select to enter selection mode
  2. Click assets to select them (or use Select All)
  3. Use the action bar to:
    • Move to... - Move selected assets to a folder
    • Delete - Delete all selected assets

Click Cancel to exit selection mode.

Filtering and Sorting

Filter by Type

Click the type tabs above the asset grid:

  • All - Show all assets
  • Images - Show only images
  • Videos - Show only videos

Sort Options

Sort your assets by:

  • Date - When uploaded (newest or oldest first)
  • Name - Alphabetically (A-Z or Z-A)
  • Size - File size (largest or smallest first)

Click a sort option to toggle between ascending and descending order.

Tips

  • Use descriptive names - "summer-campaign-hero.png" is easier to find than "image1.png"
  • Tag consistently - Use the same tags across similar assets for easier filtering
  • Organize by project - Create folders for campaigns or product launches
  • Replace, don't re-upload - Use "Replace File" to update assets globally
  • Check usage before deleting - Avoid breaking Stories by checking where assets are used
  • Clean up regularly - Delete unused assets to keep your library organized

For Developers: See the Developer Documentation for SDK integration details.