Assets

Assets are records that store data about shared resources like images and videos. Shapes reference assets by ID rather than embedding files directly, so you can reuse the same image across multiple shapes without duplicating data.

For the complete guide to working with assets, see the Assets reference.

Default storage behavior

TLAssetStore controls how assets are stored and retrieved. The default behavior depends on your store setup:

• In-memory only (default): inlineBase64AssetStore converts images to data URLs
• With persistenceKey: Assets are stored in the browser's IndexedDB
• With a sync server: Implement TLAssetStore to upload to a storage service like S3

Examples

• Using hosted images
• Customizing default asset options
• Handling pasted/dropped external content
• Simple asset store with server upload
• Asset store with image optimization