---
title: "<object> Element"
url: https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/object-descriptor-element
docs_index: https://docs.zeroc.com/llms.txt
---

> For an index of every page, see [llms.txt](https://docs.zeroc.com/llms.txt).

# \<object> Element

An `object` element defines a [well-known object](https://docs.zeroc.com/ice/3.8/services/icegrid/well-known-objects.md) in the IceGrid registry. Clients can refer to this object using only its identity, or they can search for well-known objects of a specific type.

This element may only appear as a child of an [adapter](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/adapter-descriptor-element.md) element or a [replica-group](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/replica-group-descriptor-element.md) element.

The following attributes are supported:

| **Attribute** | **Description** | **Required** |
| --- | --- | --- |
| `identity` | Specifies the identity by which this object is known. | Yes |
| `property` | Specifies the name of a property to generate that contains the stringified identity of the object. This attribute is only allowed if this `object` element is a child of an [adapter](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/adapter-descriptor-element.md) element. | No |
| `type` | An arbitrary string used to group objects. By convention, the string represents the most-derived Slice [type ID](https://docs.zeroc.com/ice/3.8/slice/type-ids.md) of the object, but an application is free to use another convention. | No |
| `proxy-options` | The proxy options to use for the proxy of the well-known object return by IceGrid. | No |

Here is an example to demonstrate the use of this element:

```xml
<adapter name="MyAdapter" id="WellKnownAdapter" ...>
    <object identity="WellKnownObject"
            type="::Module::WellKnownInterface"
            proxy-options="-o"/>
</adapter>
```

In the configuration above, the object can be located via the equivalent proxies `WellKnownObject` and `WellKnownObject@WellKnownAdapter`.

## See Also

- [Well-Known Objects](https://docs.zeroc.com/ice/3.8/services/icegrid/well-known-objects.md)
- [Adapter Descriptor Element](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/adapter-descriptor-element.md)
- [Replica-Group Descriptor Element](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/replica-group-descriptor-element.md)
- [Type IDs](https://docs.zeroc.com/ice/3.8/slice/type-ids.md)
