FAQ - How To Update Blueprint on Home Assistant Version: 2023.12.0 +
Home assistant has added an new feature this month on how we can update our blueprints
If you have imported a blueprint using the import blueprint button you can now easily update them. Below are the steps if you would like to update your blueprint this way.
From time to time when I update my blueprint there may be a breaking change or something that is required to do. I would strongly recommend that you do a full backup of your Home Assistant before you update any blueprint this way. You can also go onto the post of the blueprint as normally I will notify you of any changes but also note, sometimes I donât notify you. That is why it is always a good idea to do a full backup of your Home Assistant before updating. This way you can always easily roll back if something goes wrong
HOW TO UPDATE A BLUEPRINT
1 - First most important, do a full backup of your Home Assistant, and store it in a location where you can get to it if you brick your Home Assistant (on a separate computer not running Home Assistant).
2 - Go into settings / automation & scenes / click on the blueprint tab at the top and then the 3 dots next to the blueprint you would like to update.
3 - A pop up will appear and you will see you have an option to âre-import blueprintâ.
When you click on the âre-import blueprintâ you will get a confirmation to âre-importâ.
STOP Have you done a full backup If you are happy with everything (again, a backup of HA) then and only then should you click the âre-importâ button.
Once you click the âre-import blueprintâ button a confirmation message will appear down the bottom.
Your done!! You blueprint is updated
To check everything was done correctly, go into your automation and or the blueprint, you should see the new version displayed at the top confirming you are on the latest.
If it is greyed out and you canât select the âre-import blueprintâ button then keep following the steps.
4 - At the top of my blueprints there will be a import blueprint button and also a link to my GitHub. If click on the import blueprint and follow the steps and click preview your will see override blueprint. This will confirm that your file path is correct and it will update the blueprint.
STOP - Have you done a full backup because you get no warning⌠it is going to happen if you click the âOverride Blueprintâ button.
If you are happy with everything (again, a backup of HA) then and only then should you click the âOverride Blueprintâ button.
You have now updated a blueprint .
If you click on GitHub link and go to the blueprint you would like to update and copy the URL as shown below.
For this blueprint âBathroom Humidity Exhaust Fanâ the URL is;
https://gist.github.com/Blackshome/8e09a8213b834f1be4ab49ba880abed8
Each blueprint will have itâs own URL, so it is important that you copy the correct one you would like to update.
5 - Under the blueprint tab click on âImport Blueprintâ. A pop up will appear.
In the blueprint address paste the URL of the blueprint you would like to update and click preview.
The blueprint will be displayed and if you have installed the blueprint into the correct file location you will see a âCancelâ and an âOverride Blueprintâ button. If not you will see an âImport Blueprintâ button. If you see the âimport blueprintâ button jump to step 6. If you see âOverride Blueprintâ button then keep reading.
Scroll down to read all the documentation including the warning from HA.
STOP - Have you done a full backup because you get no warning⌠it is going to happen if you click the âOverride Blueprintâ button.
If you are happy with everything (again, a backup of HA) then and only then should you click the âOverride Blueprintâ button.
You have now updated a blueprint .
To check everything was done correctly, go into your automation and or the blueprint, you should see the new version displayed at the top confirming you are on the latest.
6 - Not Working For You - Looks like you manually installed the blueprint. If that is the case then you will have to manually update it. Click Here to go through the steps on how to do that.
But Wait!! If you would like to take advantage of this new update feature then you will have to import the blueprint again. Then update all of your automations, but check out the âTipâ below as it is not that hard to do.
-
TIP - In the YAML file of your existing automations is a file path. Once you imported the blueprint into your HA you can just change the file path to the new location in your existing automations. If you are unsure of the file path just add a test automation with the newly imported blueprint and go into your automation, top right 3 dots, Edit in YAML, and you will see the file path. Then copy the path of the newly imported blueprint automation.
Before you update the path: First copy the YAML of the existing automation you would like to update and save it in another file as your back up, yes I like back ups.
Once you have the new file path, use this file path in the existing automations you would like to update by replacing it with the new file path and clicking save. Do one at a time and check if it worked. You will then be able to use the new update feature in the future
Hope this helps you.
Enjoy
Blacky
Back to FAQ: Click Here