> ## Documentation Index
> Fetch the complete documentation index at: https://rive.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Shape Builder

> Merge and subtract vector shapes.

export const YouTube = ({id, timestamp}) => {
  const videoSrc = timestamp ? `https://www.youtube.com/embed/${id}?start=${timestamp}` : `https://www.youtube.com/embed/${id}`;
  return <iframe width="100%" height="400" src={videoSrc} title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerPolicy="strict-origin-when-cross-origin" allowFullScreen />;
};

export const Marketplace = ({href, children}) => {
  const hrefWithTracking = `${href}?utm_source=docs&utm_medium=docs_link_card&utm_campaign=docs_to_marketplace_links`;
  return <Card title="Learn by remixing" icon="external-link" href={hrefWithTracking} arrow="true" horizontal>
      {children ? children : "Open this file on Marketplace, then click Remix to experiment in the Rive Editor."}

    </Card>;
};

export const VideoEmbed = ({src}) => {
  return <div>
      <video src={src} autoPlay loop muted playsInline style={{
    width: "100%",
    height: "100%",
    borderRadius: 0,
    margin: 0,
    display: "block",
    objectFit: "cover",
    backgroundColor: "transparent"
  }} />
    </div>;
};

The Shape Builder tool lets you create new shapes by combining or subtracting vector shapes. Instead of editing paths manually, you can drag across regions to merge them or remove unwanted sections.

<YouTube id="dhT1ZiubXxU" />

<Marketplace href="https://rive.app/community/files/28403-shape-builder/" />

<Steps>
  <Step title="Select your shapes">
    Select two or more vector shapes.
  </Step>

  <Step title="Activate the Shape Builder tool">
    Click the **Shape Builder** tool from the **Create Tools** menu in the Toolbar or press **Shift** + **M**.
  </Step>

  <Step title="Merge regions">
    Drag across adjacent regions to merge them into a single shape.

    <VideoEmbed src="https://static.rive.app/video/combine-region.mp4" />
  </Step>

  <Step title="Subtract regions">
    Hold <kbd>Alt</kbd> (Windows) or <kbd>Option</kbd> (macOS) while dragging or clicking to remove regions from the shape.

    <VideoEmbed src="https://static.rive.app/video/subtract-region.mp4" />
  </Step>
</Steps>
