createShapeId • tldraw Docs

Creates a new shape ID.

function createShapeId(id?: string): TLShapeId;

Example

// Create a shape with auto-generated ID
const shapeId = createShapeId(); // "shape:abc123"

// Create a shape with custom ID
const customShapeId = createShapeId("my-rectangle"); // "shape:my-rectangle"

// Use in shape creation
const newShape: TLGeoShape = {
  id: createShapeId(),
  type: "geo",
  x: 100,
  y: 200,
  // ... other properties
};

Parameters

Name	Description
`id`	`string;` Optional custom ID suffix. If not provided, a unique ID will be generated

Returns

TLShapeId;

A new shape ID with the "shape:" prefix