Reference · Reference
Topics and limits reference
Every topic a device or gateway uses, in one table, plus naming rules.
Updated 11 Nov 20261 min read
All ThingsX IoT Core pages
- What ThingsX IoT Core does
- Quick start: connect your first device
- Key concepts
- Security and access
- Connect Wi-Fi and IoT devices
- BLE gateways, shelf labels and child devices
- LoRaWAN sensors and gateways
- Industrial I/O modules
- Device twins and state
- Send commands to devices
- Rules: react to device messages
- SDK and REST API
- Monitor your fleet and support customers
- Moving from another IoT platform
- From AWS IoT Core
- From Azure IoT Hub and other platforms
- Device can't connect
- Devices keep disconnecting or reconnecting
- Data isn't arriving or a rule doesn't fire
- Frequently asked questions
- Topics and limits reference
Device topics
| Purpose | Topic | Direction |
|---|---|---|
| Telemetry | tic/things/<name>/telemetry | Up |
| Events | tic/things/<name>/events | Up |
| Commands | tic/things/<name>/commands/<id> | Down |
| Command response | tic/things/<name>/commands/<id>/response | Up |
| Twin update / get / delete | $tic/things/<name>/twin/update, /get, /delete | Up |
| Twin replies | …/accepted, …/rejected, …/delta, …/documents | Down |
| Named twin | $tic/things/<name>/twin/name/<twin>/update and so on | Both |
Gateway topics
| Purpose | Topic | Direction |
|---|---|---|
| Uplinks for the gateway and its children | gateway/<gateway>/event/up/<kind> | Up |
| Commands for a child | gateway/<gateway>/event/down/esl-command | Down |
Naming
- Thing names: letters, digits,
-,_and:, up to 128 characters. The name is the device's client ID. - Rule names: letters, digits and
_. - Attribute values are searchable on the Things page and in Customer lookup, so use what your team says on the phone: store codes, zones, asset tags.
Ports
| Port | Use |
|---|---|
| 8883 | MQTT over TLS |
| 8443 | MQTT over secure WebSocket |
| 1883 | Plain MQTT, private networks only |
Was this page helpful?
Can't find what you need? Contact support or read about ThingsX IoT Core.