Creating HA Addon, translations/descriptions are not working for Lists?

Hey, created an addon, i have issues creating the translation file to make comments to the options

Created this file:

As you can see, i have 3 sections
Its possible to create a list of devices => this part fails, it doesnt take the discription/name from that translations file
The sections system/mqtt are working…

Here you can see the output how it looks like:

All the yellow part is ok, but not the “add” section to create a device:
here is the confoig file:

I ran in to the same issue and fixed it. Starting with 2026.4!

1 Like

Wow, that’s good news!! Gonna update my addon later!

1 Like

hey @Skaronator

i already had it like yours example, im running 2026.4.2 , but i still dont see the correct translation?

any idea whats wrong with my file?

example:

also tried to indent the fields like below, but didnt work?


configuration:
  # Translation for the entire 'doorbells' section/list
  doorbells:
    name: Doorbell List (Add your device here with the correct settings, MQTT is not needed ir you use the built-in broker, if your device doesnt provide the RING event (Indoor Stations), there is an call_state_poll option to manually poll the call state)
    description: Add one or more Hikvision doorbells.
    item:
      name: Doorbell
      description: A single Hikvision device configuration.
      fields:
        # Translations for the fields *inside* each doorbell entry
        name:
          name: Name
          description: >-
            The name that will be used for the MQTT device.
        ip:
          name: Ip Address
          description: >-
            The IP address of your Hikvision device.
        port:
          name: Port
          description: >-
            The port to connect to your Hikvision device. If not specified, the default port 8000 will be used
        username:
          name: Username
          description: >-
            This must be an admin user to login to the device.
        password:
          name: Password
          description: >-
            The password for the admin user.
        output_relays:
          name: Output Relays
          description: >-
            (optional) Set this option if you don't see the correct number of door switches or if you have attached an secure door control module on your indoor
        scenes:
          name: Scenes
          description: >-
            (optional) Poll scenes/alarm state every 15 seconds, only for Indoor Panels that support scenes
        call_state_poll:
          name: Call State Poll Interval
          description: >-
            (optional) Make the call state poll every x sec, for devices that dont support the ringing event, devices for example running 3.7.x or newer...
#  Translation for the 'system' section
  system:
    name: System
    description: >-
      System configuration options.
    fields:
      log_level:
        name: Log Level
        description: >-
          NONE|ERROR|INFO|DEBUG.
      sdk_log_level:
        name: SDK Log Level
        description: >-
          NONE|ERROR|INFO|DEBUG.
# Translation for the 'mqtt' section
  mqtt:
    name: Mqtt
    description: >-
      (optional) MQTT configuration to connect to an external MQTT broker. when not configured, the built-in MQTT broker of Home Assistant will be used.
    fields:
      host:
        name: Host
        description: >-
          The hostname or IP address of the MQTT broker.
      port:
        name: Port
        description: >-
          The port of the MQTT broker.
      ssl:
        name: Use SSL
        description: >-
          Whether to use SSL to connect to the MQTT broker.
      username:
        name: Username
        description: >-
          The username to connect to the MQTT broker.
      password:
        name: Password
        description: >-
          The password to connect to the MQTT broker.

or is it not released yet maybe? i dont see the PR in the releases?

It works fine for me on 2026.04. Weird that it doesn’t work for you. Your config look good to me the only difference I have is that I don’t use the item block.

You can check mine:

It works just fine:

You can test it out for yourself by installing my app. You don’t need to start it to see the configuration → GitHub - Skaronator/InkBridge: A lightweight App to capture Home-Assistant dashboard screenshots and optimize them for eInk displays. · GitHub

well, i tried it with your addon, and it doesnt show text either for me?
are you sure your PR is already merged? maybe its working for you because if cache when you were testing your PR,

because if i look in the frontend releases:

i dont see your PR listed there in the last releases, also not in the 2024.4 milestone?

My version:

* Installation methodHome Assistant OS
* Core2026.4.2
* Supervisor2026.04.0
* Operating System17.2
* Frontend20260325.7

Thats really weird because I’m on the same release ant it works just fine.

  • Core 2026.4.2
  • Supervisor 2026.04.0
  • Operating System 17.2
  • Frontend 20260325.7

Yes, you can see the commit here: Add translation support for nested app configuration schemas (#30121) · home-assistant/frontend@2fec5a4 · GitHub

Its available in these version according to the GitLab UI:

  • 20260325.7
  • 20260325.6
  • 20260325.5
  • 20260325.4
  • 20260325.3
  • 20260325.2
  • 20260325.1
  • 20260325.0

This cannot be it since I was developing it locally and my real home-assistant machine never saw that code.

I just opened the setting menu on my phone and it just works fine there as well.

Really weird.

Very strange… Can you do the test once again on your system with incognito mode?
Don’t get it why I don’t see the text using your addon?

Tried also with android app, stopped it cleared cache first… No text there with your addon :slight_smile:

also tested now another HA instance from a friend, nu text visible either :slight_smile:

updated to core 2026.5.0 , and now it works!