# addNeedle

Gauge-only — add a needle (dial variant).

Canonical: https://chart.syidax.com/docs/methods/addNeedle/

<a id="definition"></a>

## Definition

```typescript
addNeedle(needle: GaugeNeedleSpec, opts?: { insertAt?: number }): Promise<number>
```

| Arguments | Type | Required |
| --- | --- | --- |
| `needle` | `GaugeNeedleSpec` | Required |
| `opts` | `{ insertAt?: number }` | Optional |

Return type: `Promise<number>`. Call the method after element registration and await its Promise result.

- [GaugeNeedleSpec](https://chart.syidax.com/docs/types/GaugeNeedleSpec.md) — Type definition

<a id="related"></a>

## Related charts

- [sy-gauge-chart](https://chart.syidax.com/docs/components/gauge.md#method-addNeedle)