Skip to content

🎥 Make videos programmatically with React

docs updates

JonnyBurgere094cddb7d34
diff --git a/packages/docs/elements/captions/index.mdx b/packages/docs/elements/captions/index.mdx
index 80c9a54d33..1f0cf8670f 100644
--- a/packages/docs/elements/captions/index.mdx
+++ b/packages/docs/elements/captions/index.mdx
@@ -7,18 +7,25 @@ import {ElementLibrary} from '@site/src/components/Elements/ElementLibrary';
# Captions
-## Importing captions into Studio<AvailableFrom v="4.0.521" />
+<ElementLibrary category="captions" />
-<div>
-<Step>1</Step> Install an Element from below.
-</div>
-<div>
-<Step>2</Step> Select its caption layer in Studio.
-</div>
-<div>
-<Step>3</Step> In the Captions inspector, click <kbd>Import</kbd> and choose a Remotion [`Caption[]`](/docs/captions/caption) JSON, SRT, ElevenLabs Speech-to-Text or segmented JSON, or OpenAI Whisper verbose JSON file.
-</div>
+## How to use
-<AvailableFrom v="4.0.530" /> Studio detects the format and converts it locally. Timed words retain word-level timing; exports with only timed segments produce segment-level captions. Invalid or unsupported files show an error and leave existing captions unchanged. You can choose a local file or a public asset.
+### Transcribing in the Studio
-<ElementLibrary category="captions" />
+<Step>1</Step> Select a video or audio.<br/>
+<Step>2</Step> Click <kbd>Generate captions</kbd> in the inspector.<br/>
+<Step>3</Step> Confirm installation and generate captions. <br/>
+
+### Importing captions into Studio<AvailableFrom v="4.0.521" />
+
+<Step>1</Step> Install an Element from below.<br/>
+<Step>2</Step> Select its caption layer in Studio.<br/>
+<Step>3</Step> In the Captions inspector, click <kbd>Import</kbd> and choose a file. <br/>
+
+Supported formats:
+
+- Remotion [`Caption[]`](/docs/captions/caption) JSON
+- SRT
+- ElevenLabs Speech-to-Text or segmented JSON
+- OpenAI Whisper JSON transcript (verbose mode must be on)
diff --git a/packages/docs/src/components/Elements/ElementPage.tsx b/packages/docs/src/components/Elements/ElementPage.tsx
index 74d8ea58b4..eeb5a46aba 100644
--- a/packages/docs/src/components/Elements/ElementPage.tsx
+++ b/packages/docs/src/components/Elements/ElementPage.tsx
@@ -297,9 +297,8 @@ export const ElementPage: React.FC<ElementPageProps> = ({
<p className={styles.description}>{description}</p>
{definition.category === 'captions' ? (
<p className={styles.description} style={{marginTop: 8}}>
- Have captions?{' '}
<a href="/elements/captions/#importing-captions-into-studio">
- Import captions from JSON or SRT in Studio.
+ How to use caption elements
</a>
</p>
) : null}