Maybe this PR Replace paper item in sidebar by bramkragten · Pull Request #24883 · home-assistant/frontend · GitHub
Is this still working?
For me it stopped working. I was only using it for ordering the sidebar items the way I like.
As expected, not a single test is passing. As @VietNgoc mentioned, the sidebar has been replaced completely, all its elements changed their name and their location, so this will require a complete rewrite of the majority of the logic as well as the CSS styles and potentially Custom Sidebar API will also change.
I’ll create an issue in the repo to keep track of the changes.
Regards
1 Like
Not in Home Assistant 2025.5.x. In Home Assistant 2025.4.x there are no issues.
Here is the issue:
same goes for Kiosk-mode probably…
Actually using 2025.4.4. For me 2025.5.x. has not been offered.
The change is really terrible 
In addition, we have to change a lot of tokens variables in the themes… 
yes…
well, my themes are all fine (I had already long ago removed the paper-xxx variables), except for 1 thing: I cant get the active tab icon color to work properly.
not via a direct variable (that was suggested to me in discord by the dev, nor via card_mod theme
Which brings me to my second problem: the left side menu items… well I suppose that is where Elchininet chimes in (before, I did all that with card_mod too)
Most other stuff works alright.
Well, except Kiosk mode disabling menubar items, and some other things… I now see those icky icon for Assistant and search again in the menu bar. Never use those, so had them hidden.
Not.
As well as keep-texts-in-tabs (I have created issues on each repo).
Follow the troubleshooting and let me know your results.
just as a fyi: 2025.5 theme variable changes (alert)
please add your repo link there
1 Like
Those errors are coming from custom-sidebar-v2 (a plugin that is unmaintained since 2023 and which repo is archived). You should use the new version of Custom Sidebar from which this thread is about.
Oh thanks. So I should remove custom-sidebar-v2 from hacks first?
Yes, it is unmaintained. You should install the new version following the instructions in the documentation.
Always get confused. So I followed the HACS method and restarted HA after I added the line in configuration.yaml.
frontend:
themes: !include_dir_merge_named themes
extra_module_url:
- /local/community/lovelace-card-mod/card-mod.js
# - /local/community/custom-sidebar-v2/custom-sidebar-v2.js
# - /local/community/custom-sidebar-v2/custom-sidebar-v2-fixed.js
- /hacsfiles/custom-sidebar/custom-sidebar-json.js
I had the custom order in sidebar-order.json previously in config/www/. So assume its in json format and as such do I need to place it in config/www/ folder?
The old configuration will not work because the API has changed a lot (for example, the configuration is not stored anymore in a sidebar-order.json file). Forget about what you saw in the old custom-sidebar-v2 repo, follow the provided documentation step by step and use the instructions and the examples provided there.
OK but something isn’t right for me.
configuration.yaml.
frontend:
themes: !include_dir_merge_named themes
extra_module_url:
- /local/community/lovelace-card-mod/card-mod.js
# - /local/community/custom-sidebar-v2/custom-sidebar-v2.js
# - /local/community/custom-sidebar-v2/custom-sidebar-v2-fixed.js
- /hacsfiles/custom-sidebar/custom-sidebar-json.js
then I downloaded the example sidebar-order.json and placed it in config\www and refreshed the browser but the order did not change at all. I am sure I am doing something wrong but not sure what…
As I mentioned already, sidebar-order.json doesn’t exist anymore. You don’t need to download any sidebar-order.json because the library will not search for this file. You need to follow the documentation and forget about what you saw in the old custom-sidebar-v2 repo.