Forwarder

Advanced → Forwarder defines message-routing rules that bridge MQTT topics between two brokers. Each rule subscribes to a topic on a Source Broker and republishes every message it receives to a Target Broker.

How It Works

Source Broker  ──(subscribe topic)──▶  Forwarder Rule  ──(publish)──▶  Target Broker

A forwarder rule does not transform the message by default — it forwards the payload as-is. Optionally enable Custom Script to apply a JavaScript transformation before the message is republished.

Column Reference

Column	Meaning
ID	Forwarder record ID
Name	Rule name, e.g. receive, trans-inner
Enabled	Green On = rule is active and forwarding; grey = suspended
Custom Script	Green On = a transformation script is applied before republishing
SourceBroker	The broker this rule subscribes to (topic source)
TargetBroker	The broker this rule publishes to (message destination)
Operation	Details — view and edit the rule

Configuration Fields (Add / Edit Dialog)

Field	Description
Name	Label for this forwarding rule
Enabled	Toggle to activate or suspend without deleting
Source Broker	Select from brokers defined in Broker
Target Broker	Select from brokers defined in Broker
Subscription Topic	The MQTT topic pattern to subscribe to on the Source Broker (supports + and # wildcards)
Custom Script	Enable to write a JS script that transforms the payload before it is published to the Target Broker
Notes	Free-text remarks

Typical Use Cases

• Internal bridging — forward device uplinks from the AS broker to an internal service broker for further processing (trans-inner)
• External push — forward selected topics to a customer's own MQTT broker or cloud platform
• Protocol translation — enable Custom Script to reformat payloads (e.g. rename fields, convert units) before republishing

Related Pages

• Defining broker connections → Broker
• Built-in MQTT forwarding to external brokers → MQTT Forwarder