diff --git a/source/_integrations/nordpool.markdown b/source/_integrations/nordpool.markdown
index 5a9ca8e3769..b7c3bc14c8c 100644
--- a/source/_integrations/nordpool.markdown
+++ b/source/_integrations/nordpool.markdown
@@ -39,58 +39,92 @@ Currency:
## Sensors
-Each market area will create a device which has the following sensors:
+The integration will create entities showing today's energy prices for the configured market area. Only the base energy price is shown. VAT and other additional costs are not included.
### Main sensors
-- Current price for the selected area
-- Previous price for the selected area
-- Next price for the selected area
+| Sensor | Type | Description |
+| ------------------------- | ----------------- | --------------------------------------------------------------------------------- |
+| Current price | [Currency]/kWh | The current (hourly) energy price. |
+| Previous price | [Currency]/kWh | The price of the previous hour. |
+| Next price | [Currency]/kWh | The price of the next hour. |
+| Daily average | [Currency]/kWh | The average of today's energy prices. |
-These sensors can be used to calculate your current energy cost, or to help decide whether to charge the battery now or in an hour, etc.
+### Peak & off-peak sensors
-### Block price sensors
+Additional sensors are provided for peak and off-peak blocks.
-- Block average
-- Block minimum
-- Block maximum
-- Block start time
-- Block end time
+- Peak refers to the price of the period from 8am to 8pm.
+- Off-peak 1 refers to the price of the time period from midnight to 8am.
+- Off-peak 2 refers to the average price of the time period from 8pm to midnight.
+
+
+
+
+
+| Sensor | Type | Description |
+| ------------------------------- | ----------------- | --------------------------------------------------------------------------------- |
+| [peak/off-peak] highest price | [Currency]/kWh | The hightest hourly price during the given timeframe. |
+| [peak/off-peak] lowest price | [Currency]/kWh | The lowest hourly price during the given timeframe. |
+| [peak/off-peak] average | [Currency]/kWh | The average price of the given timeframe. |
+| [peak/off-peak] time from | Datetime | The start date/time of the given timeframe. |
+| [peak/off-peak] time until | Datetime | The end date/time of the given timeframe. |
-These sensors show the minimum/maximum and average during certain blocks of the day. More known as off-peak (typically lower price) or peak hours (typically higher price).
The block price sensors are not enabled by default.
-### Daily average
-
-- Daily average
-
-The daily average sensor is not enabled by default.
-
### Diagnostic sensors
-- Last updated - indicates when the market price was last updated.
-- Currency - The selected currency.
-- Exchange rate - EUR is the base currency so will show the exchange rate used on the market place.
+| Sensor | Type | Description |
+| ------------------------- | ----------------- | --------------------------------------------------------------------------------- |
+| Currency | [Currency] | The configured currency. |
+| Exchange rate | Integer | The exchange rate between the configure currency and Euro's. |
+| Last updated | Datetime | The time when the market prices were last updated. |
-The `Exchange rate` sensor is not enabled by default.
+## Examples
-## Example
+A template sensor to add VAT and fixed cost is useful to get the actual energy cost in the energy dashboard.
-A simple template sensor to add VAT and a fixed cost from an `input_number` entity
+### UI Template
+
+Create a helper using the UI.
+1. Go to {% my integrations title="**Settings** > **Devices & Services**" %} and at the top, choose the **Helpers** tab.
+2. In the bottom right corner, select **Create helper**.
+3. Select **Template** and **Template a sensor**.
+4. Enter the fields as shown below.
+
+The template below takes the current price attributes, adds 0.1293 EUR as fixed costs and adds 21% VAT.
+
+
+
+
+
+### YAML Template
+
+A template sensor to add VAT and a fixed cost from an helper entity `input_number.add_fixed_cost`.
{% raw %}
```yaml
template:
- sensor:
- - name: "Full SE3 current price"
- unit_of_measurement: "SEK/kWh"
+ - name: "Nordpool"
+ unit_of_measurement: "EUR/kWh"
state_class: measurement
state: >
- {% set cost = states('sensor.nord pool_se3_current_price') | float(0) %}
+ # create a variable with the current price
+ {% set cost = states('sensor.nord_pool_nl_current_price') | float(0) %}
+ # create a variable with the additional fixed cost
{% set add_cost = states('input_number.add_fixed_cost') | float(0) %}
- # Add fixed cost to the spot price and add VAT (25%)
+ # Add cost and additional fixed cost. Add VAT (25%) by multiplying with 1.25 and round to 2 digits:
{{ ((cost + add_cost) * 1.25) | round(2, default=0) }}
```
{% endraw %}
+
+### Energy Dashboard
+
+To use the Nordpool integration in the **Energy** dashboard, when configuring grid consumption and production, use the **Use an entity with current price** option.
+
+
+
+
diff --git a/source/images/integrations/nordpool/nordpool-blocks.png b/source/images/integrations/nordpool/nordpool-blocks.png
new file mode 100644
index 00000000000..1be6787bb03
Binary files /dev/null and b/source/images/integrations/nordpool/nordpool-blocks.png differ
diff --git a/source/images/integrations/nordpool/nordpool_create_template.png b/source/images/integrations/nordpool/nordpool_create_template.png
new file mode 100644
index 00000000000..0aead05531e
Binary files /dev/null and b/source/images/integrations/nordpool/nordpool_create_template.png differ
diff --git a/source/images/integrations/nordpool/nordpool_energy_dashboard.png b/source/images/integrations/nordpool/nordpool_energy_dashboard.png
new file mode 100644
index 00000000000..fbf62fa245f
Binary files /dev/null and b/source/images/integrations/nordpool/nordpool_energy_dashboard.png differ
diff --git a/source/images/integrations/nordpool/nordpool_tempalte_sensor.png b/source/images/integrations/nordpool/nordpool_tempalte_sensor.png
new file mode 100644
index 00000000000..1de7a3e958a
Binary files /dev/null and b/source/images/integrations/nordpool/nordpool_tempalte_sensor.png differ