diff --git a/source/_docs/ecosystem/ios.markdown b/source/_docs/ecosystem/ios.markdown
index 1562cf8229a..d6554f1ace7 100644
--- a/source/_docs/ecosystem/ios.markdown
+++ b/source/_docs/ecosystem/ios.markdown
@@ -29,7 +29,7 @@ The app is available on the iOS App Store in every country that Apple supports.
 
 The `ios` component is the companion component for the Home Assistant iOS app. While not required, adding the `ios` component to your setup will greatly enhance the iOS app with new notification, location and sensor functions not possible with a standalone app.
 
-Loading the `ios` component will also load the [`device_tracker`][device-tracker], [`zeroconf`][zeroconf] and [`notify`][notify] platforms.
+Loading the `ios` component will also load the [`device_tracker`](/components/device_tracker), [`zeroconf`](/components/zeroconf) and [`notify`](/components/notify) platforms.
 
 ## {% linkable_title Setup %}
 
@@ -37,7 +37,7 @@ Loading the `ios` component will also load the [`device_tracker`][device-tracker
 
 The `ios` component will automatically be loaded under the following circumstances:
 
-1. The [`discovery`][discovery] component is enabled.
+1. The [`discovery`](/components/discovery) component is enabled.
 2. You have just installed the app and are at the getting started screen.
 
 Automated discovery and component loading only happens at first install of the app. You may need to wait a few minutes for the iOS component to load as the `discovery` component only scans the network every 5 minutes.
@@ -55,13 +55,8 @@ ios:
 
 {% configuration %}
 push:
-  description: Actionable push notifications configuration. See the [actionable notifications documentation][actionable-notifications] for more information.
+  description: Actionable push notifications configuration. See the [actionable notifications documentation](/docs/ecosystem/ios/notifications/actions/) for more information.
   required: false
   type: list
 {% endconfiguration %}
 
-[discovery]: /components/discovery
-[device-tracker]: /components/device_tracker
-[zeroconf]: /components/zeroconf
-[notify]: /components/notify
-[actionable-notifications]: /docs/ecosystem/ios/notifications/actions/