diff --git a/source/_integrations/broadlink.markdown b/source/_integrations/broadlink.markdown
index 22575a0b266..7c5a57867ce 100644
--- a/source/_integrations/broadlink.markdown
+++ b/source/_integrations/broadlink.markdown
@@ -629,25 +629,36 @@ Learning RF Frequency, press and hold the button to learn...
 
 Press and hold a button on the remote.
 
+You will know it succeeded when you see the following text:
 ```txt
 Found RF Frequency - 1 of 2!
 You can now let go of the button
 Press enter to continue...
 ```
 
-Press enter.
-
+If the attempt fails, you will see the error:
 ```txt
-To complete learning, single press the button you want to learn
+RF Frequency not found
 ```
+If a failure occurs, you may need to simply keep pressing the button during the `Learning RF Frequency` step, as some remotes appear to not continuously transmit when buttons are held.
 
-Short press the button and you get the code:
+After a success, do one of the following two options:
 
-```txt
-Found RF Frequency - 2 of 2!
-b2002c0111211011211121112111212110112122101121112111202210211121112110221011211121112121102210112121111021112221101121211100017b10211111211121102111212210112121111121102111212210211121102210211111211121102122102111112121101121112122101121211000017c10211111211022102111212210112121111022102112202210211121102210221011211022102122102210112121101122102122101121211100017b10211111211121102210212210112122101121102210212210221021112110221011211121112121102210112121111121102122101121221000017b1121101121112111211121211110212210112111211121211121102210211121101121112111212111211011222110112111212111112121100005dc000000000000000000000000
-Base64: b'sgAsAREhEBEhESERIREhIRARISIQESERIREgIhAhESERIRAiEBEhESERISEQIhARISERECERIiEQESEhEQABexAhEREhESEQIREhIhARISERESEQIREhIhAhESEQIhAhEREhESEQISIQIRERISEQESERISIQESEhEAABfBAhEREhECIQIREhIhARISERECIQIRIgIhAhESEQIhAiEBEhECIQISIQIhARISEQESIQISIQESEhEQABexAhEREhESEQIhAhIhARISIQESEQIhAhIhAiECERIRAiEBEhESERISEQIhARISERESEQISIQESEiEAABexEhEBEhESERIREhIREQISIQESERIREhIREhECIQIREhEBEhESERISERIRARIiEQESERISERESEhEAAF3AAAAAAAAAAAAAAAAA=='
-```
+1. To learn a single button press RF code, press enter and follow the prompt:
+    ```txt
+    To complete learning, single press the button you want to learn
+    ```
+    Short press the button and you get the code:
+    ```txt
+    Found RF Frequency - 2 of 2!
+    b2002c0111211011211121112111212110112122101121112111202210211121112110221011211121112121102210112121111021112221101121211100017b10211111211121102111212210112121111121102111212210211121102210211111211121102122102111112121101121112122101121211000017c10211111211022102111212210112121111022102112202210211121102210221011211022102122102210112121101122102122101121211100017b10211111211121102210212210112122101121102210212210221021112110221011211121112121102210112121111121102122101121221000017b1121101121112111211121211110212210112111211121211121102210211121101121112111212111211011222110112111212111112121100005dc000000000000000000000000
+    Base64: b'sgAsAREhEBEhESERIREhIRARISIQESERIREgIhAhESERIRAiEBEhESERISEQIhARISERECERIiEQESEhEQABexAhEREhESEQIREhIhARISERESEQIREhIhAhESEQIhAhEREhESEQISIQIRERISEQESERISIQESEhEAABfBAhEREhECIQIREhIhARISERECIQIRIgIhAhESEQIhAiEBEhECIQISIQIhARISEQESIQISIQESEhEQABexAhEREhESEQIhAhIhARISIQESEQIhAhIhAiECERIRAiEBEhESERISEQIhARISERESEQISIQESEiEAABexEhEBEhESERIREhIREQISIQESERIREhIREhECIQIREhEBEhESERISERIRARIiEQESERISERESEhEAAF3AAAAAAAAAAAAAAAAA=='
+    ```
+
+2. To learn a button hold RF code, hold the button you wish to learn for 1-2 seconds then immediately press enter.  
+    * You will see the same prompts for a short press as shown above. You should see it return a different base64 code.
+    * Test the base64 code to ensure it performs the button 'hold' command as expected, rather than the button 'press' command.
+    * This might take some trial and error to get the hold timing right before hitting enter to scan for the code.
 
 ### Conversion of codes from other projects