From 5ee1aedce77406918a20f56220204d8a93ff78ec Mon Sep 17 00:00:00 2001
From: Zac West <74188+zacwest@users.noreply.github.com>
Date: Thu, 13 Aug 2020 09:00:17 -0700
Subject: [PATCH] Add /tag/* rewrite to serve instructions about NFC/QR/etc.
 tags (#14242)

---
 source/_redirects         |  4 ++++
 source/tag/index.markdown | 28 ++++++++++++++++++++++++++++
 2 files changed, 32 insertions(+)
 create mode 100644 source/tag/index.markdown

diff --git a/source/_redirects b/source/_redirects
index 7f1aac2215e..1bc16252c9c 100644
--- a/source/_redirects
+++ b/source/_redirects
@@ -2120,6 +2120,10 @@
 # Redirect old /demo to new demo page
 /demo https://demo.home-assistant.io
 
+# Functionality-required redirects
+# This is a 200 so /tag/anything is a valid URL
+/tag/* /tag 200
+
 # Lovelace documentation
 /lovelace/entity-button /lovelace/button
 /lovelace/views /lovelace/dashboards-and-views
diff --git a/source/tag/index.markdown b/source/tag/index.markdown
new file mode 100644
index 00000000000..a49fc99341e
--- /dev/null
+++ b/source/tag/index.markdown
@@ -0,0 +1,28 @@
+---
+title: "URL-Based Tag"
+description: "The landing page for URL-based tags"
+sidebar: false
+---
+
+You've reached this page because you navigated to an NFC, QR Code, or other URL-based tag in the format `https://www.home-assistant.io/tag/{tag}`. When the Home Assistant app is installed, it will [handle the tag](https://companion.home-assistant.io/docs/integrations/universal-links/).
+
+## iOS
+
+If you arrived here after scanning a tag on iOS, and you have the [Home Assistant Companion App](https://companion.home-assistant.io) installed, you may need to activate Universal Links:
+
+1. Long-press on [this link](https://www.home-assistant.io/tag/example_from_documentation)
+1. Choose "Open in 'Home Assistant'"
+1. Attempt to scan the tag again
+
+If you do not have it, you must [install the iOS app](https://apps.apple.com/us/app/home-assistant/id1099568401?mt=8) for these tags to function.
+
+## Android
+
+If you arrived here after scanning a tag on Android, and you have the [Home Assistant Companion App](https://companion.home-assistant.io) installed, you may need to change the link settings.
+
+1. Launch Settings and navigate to "Apps & Notifications", revealing the "Advanced" section if necessary
+1. Navigate to "Default apps" and then "Opening links"
+1. Open the "Home Assistant" settings and choose "Clear defaults"
+1. Attempt to scan the tag again, choosing to open in Home Assistant
+
+If you do not have it, you must [install the Android app](https://play.google.com/store/apps/details?id=io.homeassistant.companion.android) for these tags to function.