Asset Management

Overview

Once assets are uploaded, PlayableLabs provides tools to keep your library organized and up to date. You can edit metadata, replace files without breaking references, delete unused assets, and track where each asset is used.

Folder Navigation

Navigate your asset library using folder breadcrumbs at the top of the asset view:

• All Assets → Root folder
• All Assets > Backgrounds > Seasonal → Nested folder path

Click any breadcrumb to jump to that folder. Folders help organize large asset libraries by game, type, or campaign.

Viewing Asset Details

Click any asset in the library to open its detail modal. You will see:

• Preview -- Visual, audio, video, or 3D model preview
  • 3D Models -- Interactive viewer with drag to rotate, scroll to zoom, right-drag to pan
• File info -- File size, MIME type
• Metadata -- Name, folder location, tags, description (if set)
• Timestamps -- Created and updated dates (relative time format)

Available Actions

From the detail modal:

• Download -- Save asset to your device
• Edit -- Update metadata (name, tags, description)
• Delete -- Remove asset permanently

Editing Metadata

1. Open the asset detail panel
2. Click Edit (or click directly on the name/description fields)
3. Update any of the following:
   • Name -- A descriptive label for the asset
   • Description -- Optional context about the file
   • Tags -- Keywords for search and filtering
4. Click Save

Metadata changes take effect immediately and are reflected everywhere the asset appears.

Tip: Use tags consistently across your team. For example, always use "background" instead of mixing "bg", "background", and "backdrop".

Quick Actions

Copy URL

To get the public CDN/storage URL of an asset:

1. Click the asset to open the detail modal
2. Click the Copy URL button from the action dropdown
3. The URL is copied to your clipboard

Use this URL to reference assets externally or share previews with your team.

Move Assets

To organize assets into different folders:

1. Click the asset to open its action menu
2. Select Move
3. Choose the destination folder from the tree (or select "Root" to move out of folders)
4. Click Move

The asset remains accessible at the same URL but appears in the new folder location.

Bulk Actions

Select multiple assets using checkboxes, then use the action bar to:

• Move -- Relocate selected assets to a folder
• Download -- Download all selected assets
• Delete -- Remove multiple assets at once

Deleting Assets

Single Delete

1. Open the asset detail panel
2. Click Delete
3. Review the usage warning (if the asset is referenced by any games)
4. Confirm the deletion

Bulk Delete

1. Select multiple assets using the checkboxes in the asset library
2. Click Delete from the action bar
3. Review the summary of affected references
4. Confirm the deletion

Warning: Deleting an asset that is actively used in a game version or variant will break those references. Always check the usage panel before deleting.

Reusing Assets Across Games

Assets belong to your organization, not to a single game. This means you can use the same asset in multiple games, versions, and variants without uploading it again.

To reuse an asset:

1. Open the target game's Assets tab or the customization editor
2. Browse the organization's asset library
3. Select the asset you want to use

This avoids duplicating files and keeps your storage usage efficient.

Storage and Delivery

• Storage: All assets are stored in Cloudflare R2, scoped by organization ID
• CDN: Assets are served through a CDN for fast loading in the preview editor
• Export: During export, assets referenced in parameters are automatically converted to base64 and embedded in the single-file HTML output

Next Steps

• Upload new assets to expand your library
• Organize assets into collections for better structure