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

# nx:text-params-set

> Sets the style, content, and transform expressions of a text layer

Changes the typography, colors, content, position, and transform expressions of a text layer. Set only the parameters you want to change. The rest of the layer stays as it is.

## Examples

### Basic text modification

```json theme={null}
{
  "type": "function",
  "name": "nx:text-params-set",
  "params": {
    "layerName": "Title",
    "textValue": "Hello World!",
    "fontSize": 48,
    "fillColor": "#ffffff"
  }
}
```

### Complete text styling

```json theme={null}
{
  "type": "function",
  "name": "nx:text-params-set",
  "params": {
    "layerName": "Styled Text",
    "textValue": "Custom Text",
    "font": "Arial-Black",
    "fontSize": 36,
    "fillColor": [1, 1, 1],
    "strokeColor": [0, 0, 0],
    "strokeWidth": 2,
    "applyStroke": true,
    "justification": "center",
    "tracking": 100
  }
}
```

### Text with positioning and expressions

```json theme={null}
{
  "type": "function",
  "name": "nx:text-params-set",
  "params": {
    "layerName": "Animated Title",
    "textValue": "Dynamic Text",
    "positionValue": [960, 540],
    "scaleExpression": "wiggle(2, 10)",
    "opacityExpression": "Math.sin(time * 2) * 50 + 50"
  }
}
```

## Parameters

> [!NOTE]
>
> This function has no `composition` parameter. It changes text layers named `layerName` in every composition of the project. The API rejects parameters that are not listed on this page.

> [!NOTE]
>
> Values of `0`, `false`, or an empty string are skipped, so they leave the layer as it is. For example, `"applyFill": false` does not turn the fill off, and `"tracking": 0` does not reset tracking.

### Typography

**font** `string`

PostScript name of the font, for example `Arial-Black`

**fontSize** `number`

Font size in points

**tracking** `number`

Letter spacing/tracking value

### Appearance

**fillColor** `array | string`

Fill color in multiple formats:

* RGB arrays of exactly three numbers: `[1,1,1]` (0-1 range) or `[255,255,255]` (0-255 range)
* Hex strings: `#ffffff` or `#fff`

**strokeColor** `array | string`

Stroke color in multiple formats:

* RGB arrays of exactly three numbers: `[1,1,1]` (0-1 range) or `[255,255,255]` (0-255 range)
* Hex strings: `#ffffff` or `#fff`

**strokeWidth** `number`

Width of the text stroke

**strokeOverFill** `boolean`

Whether stroke appears over fill

**applyStroke** `boolean`

Whether to apply stroke to text

**applyFill** `boolean`

Whether to apply fill to text

### Layout

**justification** `string`

Text alignment: `left`, `right`, or `center`. Other values are rejected.

**positionValue** `array`

\[x, y] position coordinates, as exactly two numbers

### Content

**layerName** `string | string[]` *required*

Name of the text layer to modify. Pass an array of names to change several layers.

**textValue** `string`

The actual text content

**textExpression** `string`

After Effects expression for text

### Animation

**positionExpression** `string`

After Effects expression for position

**scaleExpression** `string`

After Effects expression for scale

**opacityExpression** `string`

After Effects expression for opacity


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.