---
title: "workspacePresentationIcon"
url: https://developers.dagio.ai/reference/workspace-presentation-icon/
---

# workspacePresentationIcon

   
                                  
                                                                                    
                                             
                  
           
          
   

This reference describes the full structure of `workspacePresentationIcon`. Paths include nested objects, list items and conditional branches. A branch selected by `kind`, `contract` or `mode` only admits its own properties.

## Structure and values

| Field | Options / expected values | Description |
| --- | --- | --- |
| `catalog` | `Managed by Surface; supplied by the Model tools.` | **Required.** Defines catalog for this object. Observe the type, variants and bounds in the Options column. |
| `revision` | `"0.468.0"` | **Required.** Defines revision for this object. Observe the type, variants and bounds in the Options column. |
| `name` | `string; min length 1; max length 120; semantic validation` | **Required.** Readable name of the element in its presentation context. |

## Reading the contract

A path ending in `[]` describes each list item; `{key}` describes each dictionary value. The `↻` marker refers to the same recursive expression. Closed objects reject additional properties. Semantic validation denotes an additional check: matching a type does not make a reference, permission or transition valid. References must resolve in the Model and the current user context.

An older variant cannot accept properties belonging to a newer variant. The compiler checks the version and consistency of the complete Model.

Surface manages this structure’s implementation parameters. Use Model tools to produce them; they are not values to enter in a record.

## Related references

[Complete Model index](https://developers.dagio.ai/reference/) · [Build a Model](https://developers.dagio.ai/models/)

<!-- surface-examples:start -->

## Applied examples : Consistent icons for your objects

Use users for Clients and file-text for Quotes; the picker and AI share these names.

### Configuration

Value for property `name`. [Properties and accepted values](https://developers.dagio.ai/reference/workspace-presentation-icon/).

```json
"layout-grid"
```

### Variation and connection

Fragment placed in `icon.name`. [Properties and accepted values](https://developers.dagio.ai/reference/workspace-presentation-icon/).

```json
"file-text"
```

### UI layout example

The illustrative layout below places this configuration in the Clients/Quotes app. Insert each fragment at the stated location, with Field, Query and Action references matching the Model declarations.

1. Clients
2. Quotes
3. Settings
4. Relations

<!-- surface-examples:end -->