diff --git a/source/_components/notify.twilio_sms.markdown b/source/_components/notify.twilio_sms.markdown
index 4f47534fa0d..91413c2df3f 100644
--- a/source/_components/notify.twilio_sms.markdown
+++ b/source/_components/notify.twilio_sms.markdown
@@ -12,19 +12,18 @@ ha_category: Notifications
 ha_release: 0.20
 ---
 
-The Twilio notify platform enables sending notifications via SMS, powered by [Twilio](https://twilio.com).
+The `twilio` notify platform enables sending notifications via SMS, powered by [Twilio](https://twilio.com).
 
-### Configuration
+To use this nofification in your installation, add the following to your `configuration.yaml` file:
 
 ```yaml
 # Example configuration.yaml entry
 notify:
   platform: twilio_sms
+  name: NOTIFIER_NAME
   account_sid: ACCOUNT_SID_FROM_TWILIO
   auth_token: AUTH_TOKEN_FROM_TWILIO
   from_number: E164_PHONE_NUMBER
-  # Optional
-  name: NOTIFIER_NAME
 ```
 
 Configuration variables:
@@ -34,7 +33,7 @@ Configuration variables:
 - **from_number** (*Required*): An [E.164](https://en.wikipedia.org/wiki/E.164) formatted phone number, like +14151234567. See [Twilio's guide to formatting phone numbers](https://www.twilio.com/help/faq/phone-numbers/how-do-i-format-phone-numbers-to-work-internationally) for more information.
 - **name** (*Optional*): Setting the optional parameter `name` allows multiple notifiers to be created. The default value is `notify`. The notifier will bind to the service `notify.NOTIFIER_NAME`.
 
-### Usage
+### {% linkable_title Usage %}
 
 Twilio is a notify platform and thus can be controlled by calling the notify service [as described here](/components/notify/). It will send a notification to all E.164 phone numbers in the notification **target**. See the notes above regarding the `from_number` configuration variable for information about formatting phone numbers.