Skip to main content
Use Tella’s background catalog to choose from your personal uploads, workspace uploads, and Tella’s default image and animated backgrounds. Pass an item’s returned background object directly to update_clip.

​
list_backgrounds

List available backgrounds in named categories. Each item includes a descriptive name, a thumbnailUrl for previewing, and a background object for applying to a clip. Built-in names, such as Red Horizon or Plum Horizon, match the names shown when you hover over backgrounds in the editor.
​
enum<string>
Filter backgrounds by personal, workspace, or default
​
string
Filter to a returned category, such as personal, workspace, default:tella, default:macos, or default:animated
The default:animated category starts with Ambient (the clip’s screen recording, heavily blurred, while the screen is shown, and its camera otherwise), then the animated gradient presets, then the animated videos. For image and animated backgrounds, send the returned object unchanged. Tella accepts catalog URLs only when they exactly match an item visible to your authenticated account.
Last modified on October 14, 2026