---
title: "Client.publishAsync( topic, payload, [options] ) | Grafana k6 documentation"
description: "Publish messages to MQTT topics asynchronously"
---

# Client.publishAsync()

Publish a message asynchronously. Returns a promise that resolves when the message is published.

## Signature

JavaScript ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```javascript
await client.publishAsync(topic, payload, options)
```

## Parameters

Expand table

| Parameter      | Type                  | Description                                                          |
|----------------|-----------------------|----------------------------------------------------------------------|
| topic          | string                | Topic to publish to                                                  |
| payload        | string \| ArrayBuffer | Message payload (string or binary data)                              |
| options        | object                | Optional publish configuration                                       |
| options.qos    | number                | Quality of Service level (0, 1, or 2). Default: 0                    |
| options.retain | boolean               | Whether the message should be retained by the broker. Default: false |
| options.tags   | object                | Custom tags for metrics (key-value pairs)                            |

## Returns

A promise that resolves when the message is successfully published.