Version Management

Control which editor version your SDK loads. Pin to a specific release, use a channel, or self-host.

How It Works

Dragble serves the editor from versioned URLs:

• https://editor.dragble.com/latest/ — newest release (default)
• https://editor.dragble.com/stable/ — previous major, battle-tested
• https://editor.dragble.com/1.0.0/ — exact version, never changes

Setting the Editor Version

SDK (Vanilla JS)

dragble.init({
  containerId: 'editor',
  editorKey: 'db_xxx',
  editorVersion: 'latest',  // 'stable', 'latest', or exact like '1.0.0'
});

React

<DragbleEditor
  editorKey="db_xxx"
  editorVersion="1.0.0"
  onReady={() => console.log('ready')}
/>

Wrapper Props (React/Vue/Angular)

Wrappers also support SDK version control:

Prop	Type	Default	Description
sdkVersion	string	'latest'	Which SDK build to load from CDN
sdkUrl	string	—	Full SDK URL override (self-hosted)
editorVersion	string	'latest'	Which editor version to load
editorUrl	string	—	Full editor URL override (self-hosted)

Release Channels

Channel	Behavior	Use Case
latest	Newest release, updated frequently	Default for all customers
stable	Previous major, updated less often	Enterprise / risk-averse
Exact (e.g. 1.2.3)	Frozen snapshot	Compliance, strict pinning

Self-Hosting (Enterprise)

Enterprise customers can self-host both the editor and SDK using Docker images. Override the URLs to point at your infrastructure:

dragble.init({
  containerId: 'editor',
  editorKey: 'db_xxx',
  editorUrl: 'https://editor.your-company.com/',
});

When editorUrl is set, editorVersion is ignored. See the Self-Hosting Guide for Docker setup.

Precedence Rules

Layer	Resolution
Editor	editorUrl > editorVersion > default 'latest'
SDK (wrappers)	sdkUrl > sdkVersion > default 'latest'

Unknown Versions

If you pass an unrecognized version string, the SDK logs a warning and falls back to latest.