Your editor configuration and your CE.SDK package move independently. Pin the version a configuration was written for, and upgrading the package leaves the editor it produces alone.
CE.SDK sometimes changes what an unchanged configuration produces: a surface that was hardcoded becomes configurable, or a surface that was always visible gains a feature key. Pinning tells CE.SDK which generation your configuration was written against, so those changes are undone for it.
Pin a version#
cesdk.resetEditor();cesdk.setEditorCompatibilityVersion('1.82.0');Pass the CE.SDK version your configuration was written for, as '1.82' or '1.82.0'. A value CE.SDK cannot parse is ignored with a warning.
resetEditor() clears any pin, so the call goes after it. Any configuration that resets should pin.
What resetEditor() clears#
resetEditor() gives a configuration an empty editor to build on. It clears what a configuration states, and keeps what your application owns.
Cleared
| Area | What happens |
|---|---|
| Features | Every ly.img.* feature is disabled. Feature ids of your own are untouched, and predicates you registered with feature.set() still run, because they are evaluated before the enabled state. |
| Keyboard shortcuts | The shortcut registry is emptied. Registered scopes and the listening root stay. |
| UI component orders | The dock, inspector bar, canvas menu, navigation bar, canvas bars and the video timeline controls bar are cleared. The caption panel, video clip menu and layers menu keep their built-in defaults. |
| Panels | Every open panel is closed, and the view returns to default. |
| Bar placement | The navigation bar and the inspector bar return to top. |
| Pinned version | The declared compatibility version is cleared, so the incoming configuration declares its own. |
| Engine editor settings | Around 38 settings return to their defaults, covering page titles, control gizmos, mouse and touch input, snapping, grid, camera, placeholders, animation and playback. |
| Scopes | Editing scopes return to the defaults of the current role, so a setGlobalScope change a configuration made is lost. |
| Theme colors | The selection frame, page title, progress and error colors resync from the current theme. |
Kept
Asset sources, actions, translations, the theme, the locale, registered UI components and the loaded scene all survive. Asset sources are removed by each plugin’s own reset callback, which runs after the clear, so a plugin decides what it takes with it. Register a callback of your own with cesdk.onReset() to restore anything else your application needs.
Where the call goes#
The pin has to be in place before your configuration sets up features and UI, because the behavior it restores is a default your own calls should be able to override:
cesdk.resetEditor();cesdk.setEditorCompatibilityVersion('1.82.0');
// Your configuration. `enable` and `disable` are last-wins, so anything// stated here beats what the pin restored.cesdk.feature.enable('ly.img.video.timeline.controls.bar');cesdk.ui.setDockOrder([...]);Each call stores the version and runs its backfills. Pin once, before your own setup: a later call runs the backfills again over whatever you set in between.
What a pin covers#
CE.SDK keeps a list of the behavior changes a configuration can predate, each with the release it landed in. Pinning below a release undoes the entries above it, by making the same public API calls your configuration makes — no component behaves differently because a pin is set.
A pin does not hold back new capabilities. A feature that ships with its own feature key stays off until you enable it, so there is nothing to undo. See To v1.82 for the first change a pin covers.
Read the pin#
cesdk.getEditorCompatibilityVersion(); // '1.82.0', or undefinedAn unpinned configuration gets the current release’s behavior. Only a pin restores an older generation, so a configuration written before this API existed adopts it by pinning the version it was written for.
When a pin gets too old#
Old generations are retired together, in an announced release. Pinning below the oldest supported version logs a warning. The editor still runs and gets every backfill this release still has, which is the oldest supported generation, not the one you asked for. getEditorCompatibilityVersion() keeps returning the version you pinned. Move the pin up and adopt the changes it was holding back.
Enable feature keys individually#
cesdk.feature.enable('ly.img.crop') enables that key and every key below it. A feature added under ly.img.crop in a later release therefore turns itself on in a configuration you have not changed.
List the keys you want instead:
cesdk.feature.enable(['ly.img.crop.size', 'ly.img.crop.rotation']);
// Or enable the children without the parent:cesdk.feature.enable('ly.img.crop.*');The CE.SDK starter kits list every key in their features.ts, commented out where the editor does not use it, so a new key is visible as something to opt into.