Add deprecation notice to Legacy MQTT page

cdk/lambda/index.js

@@ -444,7 +444,7 @@ exports.handler = async (event) => {
     "/portal/en/kb/articles/configuration-parameters-for-devices":
       "/docs/tagoio/devices/configuration-parameters-for-devices",
     "/portal/en/kb/articles/connecting-your-mqtt-broker-to-tagoio":
-      "/docs/tagoio/integrations/networks/mqtt/connecting-your-mqtt-broker-to-tagoio",
+      "/docs/tagoio/integrations/networks/third-party-mqtt-broker",
     "/portal/en/kb/articles/control-tower": "/docs/tagoio/addons/control-tower",
     "/portal/en/kb/articles/custom-domain-configuration":
       "/docs/tagoio/addons/custom-domain/custom-domain-configuration",
@@ -524,7 +524,7 @@ exports.handler = async (event) => {
     "/portal/en/kb/articles/tagoio-mcp-ai-powered-iot-data-integration":
       "/docs/tagoio/getting-started/tagoio-mcp-ai-powered-iot-data-integration",
     "/portal/en/kb/articles/tagoio-mqtt-relay":
-      "/docs/tagoio/integrations/networks/mqtt/connecting-your-mqtt-broker-to-tagoio",
+      "/docs/tagoio/integrations/networks/third-party-mqtt-broker",
     "/portal/en/kb/articles/tags": "/docs/tagoio/getting-started/tags-system",
     "/portal/en/kb/articles/ticket-severity-options":
       "/docs/tagoio/support/ticket-severity-options",

docs/tagoio/actions/defining-actions.md

@@ -192,7 +192,7 @@ TagoIO [MQTT Broker](/docs/tagoio/integrations/networks/mqtt/mqtt.md) is availab
 exclusively for **Starter** and **Scale** accounts in the **US database
 region**. Free accounts and European database region accounts may utilize
 third‑party MQTT services with TagoIO via the
-[MQTT Relay](/docs/tagoio/integrations/networks/mqtt/connecting-your-mqtt-broker-to-tagoio.md)
+[MQTT Relay](/docs/tagoio/integrations/networks/third-party-mqtt-broker.md)
 feature.
 
 ## Post data to HTTP End-Point

docs/tagoio/actions/trigger-by-mqtt-topic.md

@@ -13,14 +13,17 @@ messages are published to the topics they are subscribed to. To learn more about
 the MQTT infrastructure used by TagoIO, see
 [MQTT](/docs/tagoio/integrations/networks/mqtt/mqtt.md).
 
-:::info
+:::warning[Deprecation Notice]
+**Legacy MQTT is deprecated.** The TagoIO MQTT Broker was available exclusively
+for Starter and Scale accounts in the US database region that upgraded before
+April 15, 2026. Accounts created or upgraded after that date do not have access
+to this feature.
 
-The TagoIO MQTT Broker is available exclusively for Starter and Scale accounts
-in the US database region. Free accounts and accounts hosted in the European
-database region may use third-party MQTT services with TagoIO via the
-[MQTT Relay](/docs/tagoio/integrations/networks/mqtt/connecting-your-mqtt-broker-to-tagoio.md)
-feature.
+Please migrate to [TagoTiP MQTT](/docs/tagotip/transports/mqtt), which supports
+all account types and regions (US and EU).
 
+Existing devices and actions will continue to function during the deprecation
+period, but no new features or bug fixes will be provided.
 :::
 
 ## Trigger categories

docs/tagoio/integrations/networks/mqtt/_category_.json

@@ -1,4 +1,4 @@
 {
-  "label": "MQTT",
+  "label": "MQTT (Legacy)",
   "collapsed": true
 }

docs/tagoio/integrations/networks/mqtt/mqtt-process-data-publish-it-and-subscribe-to-a-topic.md

@@ -5,12 +5,17 @@ tags: ["tagoio"]
 keywords: [tagoio, iot, mqtt, publish, subscribe]
 ---
 
-:::warning
-
-TagoIO MQTT Broker is available exclusively for Starter and Scale accounts in the US database region. European (EU) database region accounts cannot access this service due to new security requirements, but they may use third‑party MQTT services with TagoIO via the [MQTT Relay](/docs/tagoio/integrations/networks/mqtt/connecting-your-mqtt-broker-to-tagoio.md) feature. Free accounts can access MQTT functionality through the MQTT Relay as well.
+:::warning[Deprecation Notice]
+**Legacy MQTT is deprecated.** The TagoIO MQTT Broker was available exclusively
+for Starter and Scale accounts in the US database region that upgraded before
+April 15, 2026. Accounts created or upgraded after that date do not have access
+to this feature.
 
-For EU accounts, a public MQTT broker without SLA guarantees is planned for the future. The main purpose of that broker will be proof‑of‑concept testing.
+Please migrate to [TagoTiP MQTT](/docs/tagotip/transports/mqtt), which supports
+all account types and regions (US and EU).
 
+Existing devices and actions will continue to function during the deprecation
+period, but no new features or bug fixes will be provided.
 :::
 
 In this tutorial, you will learn how to process data, publish to a topic, and subscribe to it. The tutorial uses the **MQTTX** client throughout.

docs/tagoio/integrations/networks/mqtt/mqtt-publishing-and-subscribing.md

@@ -5,19 +5,17 @@ tags: ["tagoio"]
 keywords: [tagoio, iot, mqtt, publishing, subscribing, analysis]
 ---
 
-:::warning
+:::warning[Deprecation Notice]
+**Legacy MQTT is deprecated.** The TagoIO MQTT Broker was available exclusively
+for Starter and Scale accounts in the US database region that upgraded before
+April 15, 2026. Accounts created or upgraded after that date do not have access
+to this feature.
 
-TagoIO MQTT Broker is available exclusively for Starter and Scale accounts in
-the US database region. European (EU) database region accounts cannot access
-this service due to new security requirements, but they may use third‑party MQTT
-services with TagoIO via the
-[MQTT Relay](/docs/tagoio/integrations/networks/mqtt/connecting-your-mqtt-broker-to-tagoio.md)
-feature. Free accounts can access MQTT functionality through the MQTT Relay as
-well.
-
-For EU accounts, a public MQTT broker without SLA guarantees is planned for the
-future. The main purpose of that broker will be proof‑of‑concept testing.
+Please migrate to [TagoTiP MQTT](/docs/tagotip/transports/mqtt), which supports
+all account types and regions (US and EU).
 
+Existing devices and actions will continue to function during the deprecation
+period, but no new features or bug fixes will be provided.
 :::
 
 You can publish to your MQTT topics by coding a script that runs from an

docs/tagoio/integrations/networks/mqtt/mqtt-retain-on-tagoio-broker.md

@@ -5,10 +5,17 @@ tags: ["tagoio"]
 keywords: [tagoio, iot, mqtt, retain, broker]
 ---
 
-:::warning
+:::warning[Deprecation Notice]
+**Legacy MQTT is deprecated.** The TagoIO MQTT Broker was available exclusively
+for Starter and Scale accounts in the US database region that upgraded before
+April 15, 2026. Accounts created or upgraded after that date do not have access
+to this feature.
 
-TagoIO MQTT Broker is available exclusively for Starter and Scale accounts in the US database region. Free accounts and accounts in the European database region may use third‑party MQTT services with TagoIO via the [MQTT Relay](/docs/tagoio/integrations/networks/mqtt/connecting-your-mqtt-broker-to-tagoio.md) feature.
+Please migrate to [TagoTiP MQTT](/docs/tagotip/transports/mqtt), which supports
+all account types and regions (US and EU).
 
+Existing devices and actions will continue to function during the deprecation
+period, but no new features or bug fixes will be provided.
 :::
 
 TagoIO's MQTT broker does not natively support the standard MQTT **retain** feature. However, you can implement an equivalent workaround by using TagoIO Analysis and Actions to store the last message published to a topic and resend it when a new client subscribes.

docs/tagoio/integrations/networks/mqtt/mqtt.md

@@ -1,26 +1,22 @@
 ---
-title: "MQTT Overview"
-description: "A brief introduction to TagoIO's MQTT support, including availability restrictions, an overview of the MQTT protocol, and a diagram showing data flow between devices and the TagoIO MQTT broker."
+title: "MQTT Overview (Legacy)"
+description: "Legacy MQTT integration for TagoIO. This feature is deprecated -- please use TagoTiP MQTT instead."
 tags: ["tagoio"]
 keywords: [tagoio, iot, mqtt, broker, protocol]
 sidebar_position: 1
 ---
 
-## Important notice
+:::warning[Deprecation Notice]
+**Legacy MQTT is deprecated.** The TagoIO MQTT Broker was available exclusively
+for Starter and Scale accounts in the US database region that upgraded before
+April 15, 2026. Accounts created or upgraded after that date do not have access
+to this feature.
 
-:::warning
-
-TagoIO MQTT Broker is available exclusively for Starter and Scale accounts in
-the US database region. European (EU) database region accounts cannot access
-this service due to new security requirements, but they may use third‑party MQTT
-services with TagoIO via the
-[MQTT Relay](/docs/tagoio/integrations/networks/mqtt/connecting-your-mqtt-broker-to-tagoio.md)
-feature. Free accounts can access MQTT functionality through the MQTT Relay as
-well.
-
-For EU accounts, a public MQTT broker without SLA guarantees is planned for the
-future. The main purpose of that broker will be proof‑of‑concept testing.
+Please migrate to [TagoTiP MQTT](/docs/tagotip/transports/mqtt), which supports
+all account types and regions (US and EU).
 
+Existing devices and actions will continue to function during the deprecation
+period, but no new features or bug fixes will be provided.
 :::
 
 ## Overview
@@ -43,7 +39,7 @@ full‑featured MQTT implementation, it focuses mainly on ingesting sensor data
 into our data buckets, so some standard features such as the native **Retain**
 flag are not supported. A workaround that achieves similar functionality can be
 found in the article
-[MQTT Retain on TagoIO Broker](/docs/tagoio/integrations/networks/mqtt/connecting-your-mqtt-broker-to-tagoio.md).
+[MQTT Retain on TagoIO Broker](/docs/tagoio/integrations/networks/mqtt/mqtt-retain-on-tagoio-broker.md).
 
 For example, a temperature sensor might publish a new value to the topic
 `temperature` each time it receives an update. Devices that need to react to

docs/tagoio/integrations/networks/mqtt/connecting-your-mqtt-broker-to-tagoio.md → docs/tagoio/integrations/networks/third-party-mqtt-broker.md

@@ -1,11 +1,17 @@
 ---
-title: "Connecting your MQTT Broker to TagoIO"
-description: "This article explains TagoIO's MQTT Relay, a command-line tool that bridges an external MQTT broker and the TagoIO platform, and points to the repository and a demonstration video for setup and usage."
+title: "Bridging a Third-Party MQTT Broker"
+sidebar_label: "Third-Party MQTT Broker"
+description: "TagoIO MQTT Relay bridges an external MQTT broker and the TagoIO platform using a fast, open-source command-line tool."
 tags: ["tagoio"]
 keywords: [tagoio, iot, mqtt, broker, relay]
-sidebar_position: 2
 ---
 
+:::tip
+For direct MQTT connectivity without an external broker, use
+[TagoTiP MQTT](/docs/tagotip/transports/mqtt), which supports all account types
+and regions (US and EU).
+:::
+
 TagoIO supports MQTT connections through the MQTT Relay command-line tool. The
 relay acts as a bridge between your MQTT Broker and the TagoIO platform,
 enabling seamless integration and reliable data flow. Developed in Rust, the