Skip to main content

<Experimental.Null>

EXPERIMENTAL
This component is currently a proof of technology.

The API may change in any version. Monitor this documentation page to see breaking changes when upgrading.

This is a special component, that, when rendered, will skip rendering the frame altogether.
You can render it when you are sure that the frame is empty and save rendering time.

EmptyFrame.tsx
tsx
import { AbsoluteFill, Experimental } from "remotion";
 
export const MyComp: React.FC = () => {
  return (
    <AbsoluteFill>
      <Experimental.Null />
      <div>This will not be rendered</div>
    </AbsoluteFill>
  );
};
EmptyFrame.tsx
tsx
import { AbsoluteFill, Experimental } from "remotion";
 
export const MyComp: React.FC = () => {
  return (
    <AbsoluteFill>
      <Experimental.Null />
      <div>This will not be rendered</div>
    </AbsoluteFill>
  );
};

Rules​

1
 If this component is rendered, no screenshot will be taken during rendering
2
 In the preview, the content will be rendered with zero opacity.
3
 Even elements outside of the <Null> component will disappear.
4
 Audio will still be rendered.
5
 Effects will still be executed.
6
 If the imageFormat is jpeg, a black frame will be generated, if the imageFormat is png, a transparent frame will be generated.
7
 Only one <Experimental.Null> or <Experimental.Clipper> component can be rendered per frame. Rendering multiple is an error.

See also​