Skip to content

🎥 Make videos programmatically with React

`@remotion/studio`: Link schema guidance

JonnyBurger7322be752a04
diff --git a/packages/docs/docs/default-props-inference.mdx b/packages/docs/docs/default-props-inference.mdx
index e76fb7aee3..dec0e64f01 100644
--- a/packages/docs/docs/default-props-inference.mdx
+++ b/packages/docs/docs/default-props-inference.mdx
@@ -73,7 +73,7 @@ A property named `type` is inferred as a literal and is not editable. This preve
Use an explicit [Zod schema](/docs/schemas) if one of these values should be editable.
-## Explicit schemas take precedence
+## When to define a schema
If you pass a `schema` to [`<Composition>`](/docs/composition), Remotion uses it instead of inferring controls from `defaultProps`.
diff --git a/packages/docs/docs/passing-props.mdx b/packages/docs/docs/passing-props.mdx
index 37b08840c5..b8a38a96e5 100644
--- a/packages/docs/docs/passing-props.mdx
+++ b/packages/docs/docs/passing-props.mdx
@@ -77,7 +77,7 @@ Since <AvailableFrom v="4.0.516" inline />, Remotion also [infers basic visual e
## Optional: Define a schema<AvailableFrom v="4.0.0"/>
-You can use [Zod](https://github.com/colinhacks/zod) to [define a typesafe schema for your composition](/docs/schemas). A schema is not required for visual editing. Add one when you need validation, constraints, choices or specialized controls.
+You can use [Zod](https://github.com/colinhacks/zod) to [define a typesafe schema for your composition](/docs/schemas). A schema is not required for visual editing. See [When to define a schema](/docs/default-props-inference#when-to-define-a-schema) for cases where an explicit schema is useful.
## Input props
diff --git a/packages/docs/docs/schemas.mdx b/packages/docs/docs/schemas.mdx
index a9ba445b94..d595c2d4af 100644
--- a/packages/docs/docs/schemas.mdx
+++ b/packages/docs/docs/schemas.mdx
@@ -8,7 +8,7 @@ crumb: 'How To'
Use [Zod](https://zod.dev/) to validate the props your component accepts and to customize their controls in the Remotion Studio.
-You do not need to define a schema to [edit props visually](/docs/visual-editing). Since <AvailableFrom v="4.0.516" inline />, Remotion [infers basic controls from `defaultProps`](/docs/default-props-inference). Define a schema when you need validation, constraints, choices or specialized controls.
+You do not need to define a schema to [edit props visually](/docs/visual-editing). Since <AvailableFrom v="4.0.516" inline />, Remotion [infers basic controls from `defaultProps`](/docs/default-props-inference). See [When to define a schema](/docs/default-props-inference#when-to-define-a-schema) for cases where an explicit schema is useful.
## AI agent prompt
diff --git a/packages/docs/docs/visual-editing.mdx b/packages/docs/docs/visual-editing.mdx
index a345774d4a..ef982ed417 100644
--- a/packages/docs/docs/visual-editing.mdx
+++ b/packages/docs/docs/visual-editing.mdx
@@ -31,7 +31,7 @@ If no `schema` is specified, Remotion infers controls from `defaultProps`. See [
### Defined by a schema
-Define a [Zod schema](/docs/schemas) when you need validation, constraints or specialized controls. An explicit schema takes precedence over the controls inferred from `defaultProps`.
+See [When to define a schema](/docs/default-props-inference#when-to-define-a-schema) for cases where an explicit [Zod schema](/docs/schemas) is useful. An explicit schema takes precedence over the controls inferred from `defaultProps`.
Controls are implemented for: