diff --git a/source/_integrations/transmission.markdown b/source/_integrations/transmission.markdown
index d9eff6bd5ff..66e36b71661 100644
--- a/source/_integrations/transmission.markdown
+++ b/source/_integrations/transmission.markdown
@@ -14,27 +14,17 @@ ha_codeowners:
 ha_domain: transmission
 ---
 
-The `transmission` integration allows you to monitor your downloads with [Transmission](https://www.transmissionbt.com/) from within Home Assistant and setup automation based on the information.
+The Transmission integration allows you to monitor your [Transmission](https://www.transmissionbt.com/) BitTorrent downloads from within Home Assistant and set up automations based on that information.
 
 ## Setup
 
-To use the monitoring, your transmission client needs to allow remote access. If you are running the graphical transmission client (transmission-gtk) go to **Edit** -> **Preferences** and choose the tab **Remote**. Check **Allow remote access**, enter your username and your password, and uncheck the network restriction as needed.
-
-<p class='img'>
-  <img src='/images/integrations/transmission/transmission_perf.png' />
-</p>
-
-If everything is set up correctly, the details will show up in the frontend.
-
-<p class='img'>
-  <img src='/images/integrations/transmission/transmission.png' />
-</p>
+Your Transmission client must first be configured to allow remote access. In your Transmission client navigate to **Preferences** -> **Remote** tab and then click the **Allow remote access** checkbox. 
 
 ## Configuration
 
-Set up the integration through **Configuration** -> **Integrations** -> **Transmission**. For legacy support old transmission configuration is imported and set up as new integration. Make sure to remove `monitored_condiditions` as they are now automatically added to Home Assistant
+In Home Assistant, navigate to **Configuration** -> **Integrations** and click the plus button to add a new integration and search for **Transmission**. For legacy support old Transmission configuration is imported and set up as a new integration. Make sure to remove `monitored_conditions` as they are now automatically added to Home Assistant.
 
-To enable this sensor, add the following lines to your `configuration.yaml`:
+Alternatively, the integration can be set up via YAML by adding the following lines to your `configuration.yaml`:
 
 ```yaml
 transmission:
@@ -71,21 +61,21 @@ scan_interval:
 
 ## Integration Entities
 
-The Transmission Integration will add the following sensors and switches.
+The Transmission integration will add the following sensors and switches.
 
-Sensors:
-- transmission_current_status: The status of your Transmission daemon.
-- transmission_download_speed: The current download speed [MB/s].
-- transmission_upload_speed: The current upload speed [MB/s].
-- transmission_active_torrents: The current number of active torrents.
-- transmission_paused_torrents: The current number of paused torrents.
-- transmission_total_torrents: The total number of torrents present in the client.
-- transmission_started_torrents: The current number of started torrents (downloading).
-- transmission_completed_torrents: The current number of completed torrents (seeding)
+**Sensors**:
+- `sensor.transmission_current_status`: The status of your Transmission daemon.
+- `sensor.transmission_download_speed`: The current download speed [MB/s].
+- `sensor.transmission_upload_speed`: The current upload speed [MB/s].
+- `sensor.transmission_active_torrents`: The current number of active torrents.
+- `sensor.transmission_paused_torrents`: The current number of paused torrents.
+- `sensor.transmission_total_torrents`: The total number of torrents present in the client.
+- `sensor.transmission_started_torrents`: The current number of started torrents (downloading).
+- `sensor.transmission_completed_torrents`: The current number of completed torrents (seeding).
 
-Switches:
-- transmission_switch: A switch to start/stop all torrents
-- transmission_turtle_mode: A switch to enable turtle mode.
+**Switches**:
+- `switch.transmission_switch`: A switch to start/stop all torrents.
+- `switch.transmission_turtle_mode`: A switch to enable turtle mode (a.k.a. alternative speed limits).
 
 
 ## Event Automation
@@ -94,9 +84,9 @@ The Transmission integration is continuously monitoring the status of torrents i
 
 Possible events are:
 
-- transmission_downloaded_torrent
-- transmission_started_torrent
-- transmission_removed_torrent
+- `transmission_downloaded_torrent`
+- `transmission_started_torrent`
+- `transmission_removed_torrent`
 
 Inside of the event, there is the name of the torrent that is started or completed, as it is seen in the Transmission User Interface.
 
@@ -142,7 +132,7 @@ Removes a torrent from the client.
 
 ### Attribute `torrent_info`
 
-All `*_torrents` sensors e.g. `sensor.transmission_total_torrents` or `sensor.transmission_started_torrents` have a state attribute `torrent_info` that contains information about the torrents that are currently in a corresponding state. You can see this information in **Developer Tools** -> **States** -> `sensor.transmission_total_torrents` -> **Attributes**, or by adding a Markdown Card to Lovelace.
+All `*_torrents` sensors e.g. `sensor.transmission_total_torrents` or `sensor.transmission_started_torrents` have a state attribute `torrent_info` that contains information about the torrents that are currently in a corresponding state. You can see this information in **Developer Tools** -> **States** -> `sensor.transmission_total_torrents` -> **Attributes**, or by adding a [Markdown card](/lovelace/markdown/) to Lovelace with the following code:
 
 {% raw %}
 ```yaml