> 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 variable by name

> Retrieve a variable by its name with the Webflow Designer API.

## `collection.getVariableByName(name)`

Retrieve a variable by its name.

### Syntax

```typescript
collection.getVariableByName(name: string): Promise<null | Variable>>
```

### Parameters

* **name** : *string* - Name of the variable you'd like to retrieve

### Returns

**Promise\< *Variable* | `null`>**

A Promise that resolves to a Variable object, or `null` if not found

### Example

```typescript
// Get Collection
const collection = await webflow.getDefaultVariableCollection()

// Get Variable by Name
const variableByName = await collection?.getVariableByName('Space Cadet')
console.log(variableByName)
```

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

### Designer Ability

Checks for Authorization only

| Designer Ability     | Locale | Branch | Workflow | Sitemode |
| :------------------- | :----- | :----- | :------- | :------- |
| **canReadVariables** | Any    | Any    | Any      | Any      |