> This page is for Designer API.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.webflow.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.webflow.com/_mcp/server.

# Remove a prop (Beta)

> Removes a prop from a component

## `component.removeProp(propId)`

Removes a prop from a component by its ID.

This method removes the prop definition and disconnects any bindings on component instances that reference it.
This action mirrors the delete action available in the component props panel in the Webflow Designer and is undoable.

> **Beta**
>
> These methods are in public beta and may change with future releases.

### Syntax

```typescript
component.removeProp(propId: string): Promise<null>
```

### Parameters

* **`propId`** : *string* — The unique ID of the prop to remove.

### Returns

**Promise\<*null*>**

A Promise that resolves to `null` when the prop has been removed.

### Examples

Remove a prop found by name:

```typescript
const component = await webflow.getCurrentComponent()

if (component) {
  const props = await component.getProps()
  const unusedProp = props.find(p => p.name === 'Old Heading')

  if (unusedProp) {
    await component.removeProp(unusedProp.id)
    // Prop is deleted
  }
}
```

Remove a prop by its known ID:

```typescript
const component = await webflow.getCurrentComponent()

if (component) {
  await component.removeProp('prop_123')
}
```

Create a prop and then remove it:

```typescript
const component = await webflow.getCurrentComponent()

if (component) {
  const temp = await component.createProp({
    type: 'string',
    name: 'Temporary',
  })

  await component.removeProp(temp.id)
}
```

[Try this example](https://webflow.com/oauth/authorize?response_type=code\&client_id=19511de1ec410f9228d8dcbc9420e67916dea80d86d18f0c9a533eb475ea0f62)

### Designer Ability

| Designer Ability        | Permission | Locale | Branch | Workflow | Sitemode |
| :---------------------- | :--------- | :----- | :----- | :------- | :------- |
| **canModifyComponents** | any        | any    | any    | Canvas   | Design   |