> 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.

# Get component instance count

## `webflow.getInstanceCount(component)`

Gets the number of instances of a component.

### Syntax

```typescript
webflow.getInstanceCount(component: Component): Promise<number>
```

### Returns

**Promise\<number>**

A Promise that resolves to the number of instances of the component across the entire site.

### Example

```typescript
// Audit component usage across the site
const components = await webflow.getAllComponents();
for (const component of components) {
  const name = await component.getName();
  const count = await component.getInstanceCount();
  console.log(`${name}: ${count} instances`);
}
// Guard against removing a component that's still in use
const hero = components[0];
const instanceCount = await hero.getInstanceCount();
if (instanceCount > 0) {
  console.log(`Cannot safely remove — ${instanceCount} instances exist`);
} else {
  await webflow.unregisterComponent(hero);
}
```

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

---

### Designer Ability

Checks for authorization only

| Designer Ability    | Permission | Locale | Branch | Workflow | Sitemode |
| :------------------ | :--------- | :----- | :----- | :------- | :------- |
| **canAccessCanvas** | any        | any    | any    | any      | any      |