Skip to content

Custom panels

The editor is built from four top-level panels: Titlebar, Preview, Sidebar, Timeline. Pass a components prop to replace any of them. Your component receives the editor context via hooks — see Hooks & commands.

jsx
import { VideoEditor, useEditor } from '@ilovevideoeditor/react-video-editor';

function MyTitlebar() {
  const video = useEditor((s) => s.video);
  return (
    <header>
      <h1>{video.name}</h1>
      <button>Export</button>
    </header>
  );
}

<VideoEditor
  video={v}
  components={{ Titlebar: MyTitlebar }}
/>

Panel defaults

PanelResponsibilities
TitlebarProject name, undo/redo, Save / Export buttons.
PreviewThe DomRenderer host + transport bar.
SidebarInspector: selection props, media library, effects.
TimelineTracks, playhead, ruler, drag-and-drop.

Partial replacement

Pass only the panels you want to replace — the editor keeps its defaults for the rest.

jsx
<VideoEditor video={v} components={{
  Titlebar: MyTitlebar,
  Sidebar: ({ selection }) => selection ? <MyInspector /> : <MyMediaLibrary />,
}} />

TIP

Don't swap Preview unless you have to. It hosts the DomRenderer instance every other panel assumes exists. If you just want to add overlays, wrap the default preview inside your replacement.

Titlebar slot props

The Titlebar slot is special — when you replace it, the editor forwards the same handlers it would have given the default titlebar.

PropTypeNotes
onExport() => voidPre-bound — calls your onExport if set, otherwise opens the built-in export modal.
onSave() => voidPre-bound — calls your onSave with the current video.
branding`ReactNodenull

Released under the MIT License.