Element Property
This tab stacks the drawables, sounds, and other engine objects contained in the element selected on the timeline (the unit corresponding to a *.belm file) and lets you edit them vertically.
The element's own name, color, start time, and other timeline-level attributes are managed from the timeline; this tab is where you build out the element's contents.
Tab characteristics
- Open by default: Yes
- Allow multiple instances: Yes
How to open
Select an element on the timeline to open this tab and show its contents. It is not listed in View → Tools or the empty-tab picker.
Use Pin Tab in the tab header's right-click menu to keep that element visible. Selecting another element then uses another unpinned tab, or opens one when needed. See Keeping a tab on one object.

Layout
The objects contained in the selected element are listed vertically as expandable panels. Each panel consists of the following parts.
- Reorder handle (dots at the far left): Drag vertically to change the object's order
- Visibility toggle: Enable or disable the object
- Name label: The object's type name (hover to see a tooltip with its description)
- Expand/collapse button: Click to open or close the property area
- Property area: Shows a dedicated editor for each property when expanded
If the element contains many objects, scroll the tab vertically to browse them all.
Lists inside a panel, such as transforms, filter effects, audio effects, and path figures, show their items the same way. An expanded item's rows start under its name, and a line under its grip runs beside them. The items of a nested group start under their group's name, with a line for each level.
Working with objects
Reordering
Drag the handle on the left edge of a panel up or down to rearrange objects within the same element. The order directly affects the order in which drawing and effects are applied.
Toggling enabled / disabled
Use the eye icon in the header (the visibility toggle) to enable or disable the object. Disabled objects are excluded from drawing and processing.
Expanding / collapsing
Click the button at the right end of the header to open or close the property area. The expand/collapse state is saved per element and restored the next time you open the same element.
Right-click menu (on a panel header)
| Item | Action |
|---|---|
| Remove | Removes this object from the element |
| Save as Template | Names the object and registers it in the library as a template |
Adding objects
Drag and drop from the library
Drop items (drawables, sounds, etc.) from the Library onto this tab to add objects to the selected element. The drop position determines where the new object is inserted.
Transforms and effects
Starting transforms
A new object starts with Translate, Rotation, and Scale transforms, whether you add it from the timeline, the preview, or the library, drop it on this tab, or paste an image. The position you drop it at goes into its Translate. When you expand the Transform section, each of these transforms is open.
Adding with +
The + button and drops always add. On a Transform, Filter Effect, or Audio Effect section, a single transform or effect moves into a new group together with the new one, in one undo step, so nothing is replaced. A new transform goes where the preview's handles would put it: the first Translate on top, the first Rotation right below it, and anything else at the end, so the order you add them in gives the same result. While an expression decides the value, adding from the panel does nothing. Change and Null appear in the section's right-click menu only to repair a value that could not be loaded.
Picking from tiles
The picker that the + button opens on a Filter Effect section shows the effects as tiles. Each tile has a moving thumbnail of the effect on the object you add it to, as the object looks at the playhead, drawn on its own. A tile plays while you point at it or while it is selected, and the arrow keys move between tiles and rows. The grid button at the top of the picker switches between tiles and a list, and Beutl remembers the choice for every picker. With nothing to draw, the tiles use sample pictures that come with Beutl.
The Transition tab's type picker shows its transitions the same way, on the elements at the edge it sets. Pickers for other kinds of items, such as transforms and audio effects, show a list.
Transforms in a list
An open transform shows its first property beside its type's icon, in place of a name row, and its other properties below it, beside a line. Click the icon to close or open the transform, and drag the icon to reorder it. Right-click anywhere on the transform for Visible and Remove, along with copy, paste, and templates. A hidden transform is dimmed.
A closed transform, a group, and a transform whose type could not be loaded keep the row with the name, the eye, and the trash button. In a node, a transform also keeps that row.
Editing an effect's handles in the preview
An effect from an extension can have handles of its own in the preview. Such an effect shows a crosshair button, Edit in frame, left of its eye, both in a list and as the only effect of a section. Click it to select the effect. The preview then shows the effect's handles and hides the object's transform handles and pivot, so a drag edits only the effect. Click the object in the preview to select its element again and bring the transform handles back. The button is hidden while the tab edits several elements. No built-in effect has such handles yet.
Editing properties
Expanding an object reveals a per-property editor.
For animated properties, use the vertical three-dot menu (⋮) on the right side of the property to open the Graph Editor or to inline-expand the animation onto the timeline.
Reference properties offer a picker for existing targets, and properties with unit metadata show %, °, or × in their labels. See Choosing reference targets and the following section for details.
On properties with several values, such as a point or a color, the same menu offers Separate components to animate each value on its own. See Animating components separately. Values stored as separate properties, such as a Translate's X and Y, share one row; see Values shown in one row.
Sounds also have collapsible Panner and Channel assignment sections. See Multichannel Audio.
File fields also accept drag-and-drop: drop a local file of a supported type onto the field to select it. Easing properties provide a preset selector and a curve preview; for spline easing, drag the curve's control points to adjust it directly. The curve also takes the keyboard: Tab moves between its two control points and then on, the arrow keys move the selected one by 0.01, and Shift makes that 0.1. Each key press is one undo step. When the value column is too narrow, the curve spans the whole row.
A text field of several lines, such as the Text of a Text, wraps long lines at the field's width. Code fields keep each line as written and scroll sideways instead: the script of the GLSL Script, SKSL Script, and C# Script effects, the Code of the shader pass nodes, and the script of the C# expression node. They use a monospace font, and Tab types a tab instead of moving to the next field, in this tab and on nodes alike; Shift + Tab still moves back to the previous field. The C# expression node's script holds several lines, so Enter starts a new line there.
Scrubbing number values
Drag a number box, or its label, horizontally to scrub its value up or down. Hold Shift while scrubbing for coarse steps (10×) or Alt (Command on macOS) for fine steps (0.1×). With Enable Pointer Lock on, the cursor hides during the drag on Windows and macOS and comes back where the drag began. On a macOS trackpad, a scrub gives haptic feedback at zero and at the property's default value.
A press on a box becomes a drag only after it moves 3 pixels sideways, so a click still edits the text, with all of it selected; Enter confirms the new value. While the box shows text that does not parse, a drag does not change the value, and the release edits the text so you can correct it.
A number that has a range, such as Opacity, shows where its value sits while you point at it: the box fills up to the value, from zero when the range spans zero and from the minimum otherwise, and a slim thumb marks the value. At rest it looks like any other box.
The boxes of points, sizes, vectors, thicknesses, corner radii, and color components take a drag too. Each box moves its own component, and the single box of a uniform value moves them all. Relative points and rectangles move by 1% per pixel for a relative value and by 1 per pixel for an absolute one. Number boxes in list items, nodes, and settings pages stay plain text boxes.
Picking colors and palettes
A color field opens Beutl's color picker. The same picker opens for element, layer, and marker colors, gradient stops, the preview guide color, and the accent color. Its palette tab lists, under a New palette button:
- Recent colors: the last 20 colors a picker applied, newest first.
- The open project's palettes, marked Saved in this project.
- Your own palettes, which every project shows.
- Default palette: the CSS named colors and Transparent, from neutrals through red, orange, yellow, green, cyan, blue, purple, and pink, each from light to dark.
Click a color to pick it. Colors equal to the current one are ringed, a tooltip shows the color's name and hex value, and translucent colors show a checkerboard. In the brush editor, picking a color while the brush is unset makes a solid brush of it.
- New palette adds one of your own palettes, named Palette 1, Palette 2, and so on.
- + on a palette adds the current color.
- The palette's … button or right-click menu offers Rename, Move up, Move down, Save in this project or Use in all projects, and Delete.
- Right-click a color of a palette for Rename, Replace with the current color, Move to another palette, and Delete.
- Right-click a recent or default color for Add to palette (or Add to a new palette). A recent color also offers Remove from recent colors, and the Recent colors menu offers Clear recent colors.
Your palettes and the recent colors are kept in Beutl's preferences. A project's palettes are written to a file of their own beside the project file as soon as they change, and those edits cannot be undone.
From the keyboard, Tab stops once in each palette, at the color focused last. The arrow keys move between its colors, Left and Right in order and Up and Down a row at a time. Enter or Space picks the focused color, and the menu key opens its menu.
Editing several elements together
When several elements are selected on the timeline, a tab that is not pinned edits them together. It shows one of them with the same panels and editors as a single element, and each edit reaches every selected element as one undo step. A pinned tab keeps showing its own element.
- Only what every element has is shown. Properties match by name and type. Effects, transforms, and other list items match by type, in the order each element holds them, so the first blur of one element stands for the first blur of another. When a text and a rectangle are selected, the properties of a drawable that they share appear under a header such as Text / Rectangle.
- Each element takes an edit as its own editor would. Times move with the element: a value goes to the keyframe as far into each element as the playhead is into the one shown, or at the playhead itself in an animation that uses Use the Global Clock. When no keyframe sits at that time, the value goes to the next one, as it does when you edit one element. An element whose value an expression gives keeps it. Adding a keyframe or setting an expression works on each element's own values.
- Differing values are marked. When the elements hold different values, a dot appears on the row's ⋮ button. Its tooltip lists each element's value, and its menu offers Set All Elements to This Value. Brush, pen, and texture rows offer the types to switch to instead.
- Locked elements stay as they are. A note above the properties says how many are left out, or that the selected elements have nothing in common to edit.
- Some edits stay with the element shown. The ⋮ menu does not offer the inline animation view, and edits inside a node graph reach only the element shown.
Objects of unknown type
When the object's type cannot be resolved — for example because the providing extension is not installed — the view falls back to a placeholder. It shows the original type name along with a command bar for editing and saving the JSON directly, so you can still inspect and make minimal fixes on the spot.
Unrecognized data that can be preserved is kept on save. Common properties remain editable when the placeholder can save those changes. If an element is protected because some data could not be preserved, editing is restricted to repairing, replacing, or removing that content; see Recovering damaged elements.
Related documents
Source
ElementPropertyTabExtension.csElementPropertyTabViewModel.csEngineObjectPropertyViewModel.csElementPropertyTabView.axaml/.axaml.csEngineObjectPropertyView.axaml/.axaml.csFallbackObjectView.axaml/.axaml.csStorageFileEditor.csEasingEditor.csEasingCurveEditor.csComponentEditors.csSoundPannerEditor.axamlChannelMapEditor.axamlTransformListItemEditor.axaml/ListItemRowsPanel.csAddToGroupHelper.cs/CanonicalTransformLayout.csColorPaletteView.cs/ColorPaletteService.cs/DefaultColorPalette.csLibraryItemPickerFlyoutPresenter.axaml/SelectLibraryItemDialogViewModel.cs/LibraryThumbnailCapture.csNumberSliderEditor.cs/ValueSliderField.cs/NumberBoxDrag.cs/NumberEditorViewModel.csMultiElementEditSession.cs/PropertyEditorMenu.axamlStringEditor.axaml/CustomDataTypes.csVectorEditorBase.cs/HeaderScrubGesture.csFilterEffectEditorViewModel.cs/FilterEffectListItemEditor.axaml/TransformHandlesOverlay.cs