# How to Update Device Presentation?

**URL:** <https://community.smartthings.com/t/how-to-update-device-presentation/279805>\
**Category:** Support\
**Created:** [March 17, 2024, 11:36am UTC](https://community.smartthings.com/t/how-to-update-device-presentation/279805 "2024-03-17T11:36:25Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![romrom21](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/romrom21/32/196311_2.png) [@romrom21](https://community.smartthings.com/u/romrom21)\
**Post date:** [March 17, 2024, 11:36am UTC](https://community.smartthings.com/t/how-to-update-device-presentation/279805/1 "2024-03-17T11:36:25Z")

</div>

Hello, I created some custom devices, and I would like to update the look on the dashboard.  
Here is my device profile:

```auto
{
    "name": "weather_station_main",
    "components": [
        {
            "id": "main",
            "capabilities": [
                {
                    "id": "temperatureMeasurement"
                },
                {
                    "id": "relativeHumidityMeasurement"
                },
                {
                    "id": "carbonDioxideMeasurement"
                },
                {
                    "id": "carbonDioxideHealthConcern"
                },
                {
                    "id": "soundPressureLevel"
                }
            ],
            "categories": [
                {
                    "name": "TempSensor",
                    "categoryType": "manufacturer"
                }
            ]
        }
    ]
}

```

I tried to do a dashboard custom presentation with this :

```auto
{
    "dashboard": {
        "states": [
            {
                "component": "main",
                "capability": "temperatureMeasurement",
                "version": 1,
                "values": [
                    {
                        "key": "temperatureMeasurement.value",
                        "unit": "C"
                    }
                ]
            },
            {
                "component": "main",
                "capability": "relativeHumidityMeasurement",
                "version": 1,
                "values": [
                    {
                        "key": "relativeHumidityMeasurement.value",
                        "range": [
                            0,
                            100
                        ],
                        "unit": "%"
                    }
                ]
            },
            {
                "component": "main",
                "capability": "carbonDioxideMeasurement",
                "version": 1,
                "values": [
                    {
                        "key": "carbonDioxideMeasurement.value",
                        "unit": "ppm"
                    }
                ]
            }
        ]
    }
}

```

I then updated my device profile with the presentation in the metadata of the profile but it doesn’t look to be working.

I also have several window blinds in the same room and I am looking to group them, but I don’t really know how to link the presentation with de device since these devices are not custom like my weather station

---

<div class="post-metadata">

**Author:** ![h0ckeysk8er](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/h0ckeysk8er/32/195141_2.png) [@h0ckeysk8er](https://community.smartthings.com/u/h0ckeysk8er)\
**Post date:** [March 17, 2024, 4:14pm UTC](https://community.smartthings.com/t/how-to-update-device-presentation/279805/2 "2024-03-17T16:14:13Z")

</div>

> [@romrom21](#):
>
> I then updated my device profile with the presentation in the metadata of the profile but it doesn’t look to be working.

What part is not working?

> [@romrom21](#):
>
> I also have several window blinds in the same room and I am looking to group them, but I don’t really know how to link the presentation with de device since these devices are not custom like my weather station

Group them how?

---

<div class="post-metadata">

**Author:** ![orangebucket](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/orangebucket/32/81590_2.png) [@orangebucket](https://community.smartthings.com/u/orangebucket)\
**Post date:** [March 17, 2024, 5:11pm UTC](https://community.smartthings.com/t/how-to-update-device-presentation/279805/3 "2024-03-17T17:11:41Z")

</div>

> [@romrom21](#):
>
> I then updated my device profile with the presentation in the metadata of the profile but it doesn’t look to be working.

I think you have the process right but I don’t think the device configuration file looks right. Specifically the `values` arrays don’t look right for the `states` in the `dashboard`, they look more like the sort of thing you’d get in the `details` or the `automations` sections where the range of possible values is important.

The `states` section will be be presenting the state of the capability as a string. So the range of possible values is of no import. In the `values` array I’d expect to see an optional label to override the `label` inherited from the capability presentation, and then an optional array of `alternatives` to override a `key` with a `value`. For example, a switch will normally have _on_ and _off_ as values (the keys), but you might want _ready_ and _not ready_ instead.

[API | Developer Documentation | SmartThings](https://developer.smartthings.com/docs/api/public#tag/Presentations/operation/createCustomCapabilityPresentation)

---

<div class="post-metadata">

**Author:** ![nayelyz](https://avatars.discourse-cdn.com/v4/letter/n/59ef9b/32.png) [@nayelyz](https://community.smartthings.com/u/nayelyz)\
**Post date:** [March 20, 2024, 12:05am UTC](https://community.smartthings.com/t/how-to-update-device-presentation/279805/4 "2024-03-20T00:05:01Z")

</div>

Hi, everyone!

@romrom21, as mentioned by Graham and Bruce, we need more details about what you’re trying to do and the issue you’re facing to provide a better guidance.

> [@orangebucket](#):
>
> I’d expect to see an optional label to override the `label` inherited from the capability presentation

That’s right, this would be an example:

```auto
{
    "dashboard": {
        "states": [
            {
                "component": "main",
                "capability": "temperatureMeasurement",
                "version": 1,
                "values": [
                    {
                        "label": "Room temp: {{temperatureMeasurement.value}}{{temperatureMeasurement.unit}}"
                    }
                ]
            },
            ...
        ]
    }
}

```

By default, the capability presentation of “temperatureMeasurement” already shows the current value + unit so, unless you’re trying to customize something, you don’t need to add the property “values”.  
There’s an interesting use case in this post that I think takes advantage of this feature:

> [@UI Displaying in Dashboard / Detailview](https://community.smartthings.com/t/ui-displaying-in-dashboard-detailview/276845/9):
>
> You need to verify the configuration isn’t being cached. There are two things you need to query: The device presentation’s final result You can query the device’s presentation (the one that is created using the device configuration) to see if those changes were applied successfully by using this command: smartthings presentation VID -j --example: smartthings presentation a04d4886-7dcf-3019-a4ed-569a3cbb3fde -j You’ll see the changes you made in a slightly different format because they are placed in the corresponding properties. For example: [image] The presentation currently used by the device: Get the current device’s presentation using CLI with the command: smartthings devices:presentation UUID -j Verify it matches the last VID assigned and the configuration is the last one …

Currently, if we use your config, the values you used are ignored as shown in the result of the `presentation:device-config:create` command:

 ![image](https://global.discourse-cdn.com/smartthings/original/3X/3/9/39479be4b8df4b873948fc37fd93090e95bcac77.png)

---

<div class="post-metadata">

**Author:** ![romrom21](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/romrom21/32/196311_2.png) [@romrom21](https://community.smartthings.com/u/romrom21)\
**Post date:** [March 24, 2024, 11:05am UTC](https://community.smartthings.com/t/how-to-update-device-presentation/279805/5 "2024-03-24T11:05:24Z")

</div>

Hello,  
The part that isn’t working is how the weather station is displayed in the ST app.  
The device presentation is created but nothings happens on the device.

For the blinds, I would like to group them like this:  
[groups-27104ede47d5c0578a83ba0904f27c47.jpg (756×551) (smartthings.com)](https://developer.smartthings.com/docs/assets/images/groups-27104ede47d5c0578a83ba0904f27c47.jpg)  
With the blinds instead of the switches.

---

<div class="post-metadata">

**Author:** ![romrom21](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/romrom21/32/196311_2.png) [@romrom21](https://community.smartthings.com/u/romrom21)\
**Post date:** [March 24, 2024, 11:13am UTC](https://community.smartthings.com/t/how-to-update-device-presentation/279805/6 "2024-03-24T11:13:33Z")

</div>

Hello,  
What I’m trying to do is to change what information my weather station is displaying on the dashboard.  
For example, add the CO2 measurement and the humidity.

Like this with the dimmer and no actions available :  
[dashboard-2f98989126d31909a5a31805783b0cb7.png (945×2048) (smartthings.com)](https://developer.smartthings.com/docs/assets/images/dashboard-2f98989126d31909a5a31805783b0cb7.png)

I will try to change what I’ve done with your recommendations

---

<div class="post-metadata">

**Author:** ![orangebucket](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/orangebucket/32/81590_2.png) [@orangebucket](https://community.smartthings.com/u/orangebucket)\
**Post date:** [March 24, 2024, 12:09pm UTC](https://community.smartthings.com/t/how-to-update-device-presentation/279805/7 "2024-03-24T12:09:51Z")

</div>

> [@romrom21](#):
>
> For the blinds, I would like to group them like this:  
> [groups-27104ede47d5c0578a83ba0904f27c47.jpg (756×551) (smartthings.com)](https://developer.smartthings.com/docs/assets/images/groups-27104ede47d5c0578a83ba0904f27c47.jpg)  
> With the blinds instead of the switches.

The grouping you are seeing there applies to multiple components of a single device. So it might be something like a four gang light switch or perhaps a four-way extension lead, though generally multi-way devices are implemented as if they are multiple separate devices. It could be used for a weather station, for example, where there are a number of capabilities that could usefully be displayed on a dashboard tile.

It isn’t used to group separate devices into one tile.

---

<div class="post-metadata">

**Author:** ![romrom21](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/romrom21/32/196311_2.png) [@romrom21](https://community.smartthings.com/u/romrom21)\
**Post date:** [March 24, 2024, 2:55pm UTC](https://community.smartthings.com/t/how-to-update-device-presentation/279805/8 "2024-03-24T14:55:51Z")

</div>

So we can’t “group” 2 devices together? It seems to me that I can do that with my Philips Hue lamps though

---

<div class="post-metadata">

**Author:** ![orangebucket](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/orangebucket/32/81590_2.png) [@orangebucket](https://community.smartthings.com/u/orangebucket)\
**Post date:** [March 24, 2024, 3:48pm UTC](https://community.smartthings.com/t/how-to-update-device-presentation/279805/9 "2024-03-24T15:48:49Z")

</div>

> [@romrom21](#):
>
> So we can’t “group” 2 devices together? It seems to me that I can do that with my Philips Hue lamps though

There is certainly a specific thing called a ‘Lighting Group’ that can be created. I’ve only ever really tested it with virtual lights and I haven’t found it terrible reliable, but maybe my expectations are wrong.

---

<div class="post-metadata">

**Author:** ![nayelyz](https://avatars.discourse-cdn.com/v4/letter/n/59ef9b/32.png) [@nayelyz](https://community.smartthings.com/u/nayelyz)\
**Post date:** [March 26, 2024, 7:37pm UTC](https://community.smartthings.com/t/how-to-update-device-presentation/279805/10 "2024-03-26T19:37:03Z")

</div>

Hi, @romrom21  
As Graham mentioned, the sample you shared shows that view because the developer created a custom presentation ([here’s](https://developer.smartthings.com/docs/devices/configurations-and-presentations/device-configurations#dashboard-view) an example of that grouping) and all of those capabilities belong to the same device where this presentation is implemented. It can be a multi-component device or a single-component device, in both cases, the device’s instance is the same.  
In the presentation, we cannot make references to other devices so that’s why we cannot create a device that would show the state of others using it, you would need to mirror the events from all of those devices to that “main” device in that case, but I don’t know the details of how the weather station works.