---
title: "<service-instance> Element"
url: https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/service-instance-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).

# \<service-instance> Element

A `service-instance` element creates an instance of a [service-template](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/service-template-descriptor-element.md) element in an [IceBox](https://docs.zeroc.com/ice/3.8/services/icegrid/icebox-integration-with-icegrid.md) server. It may supply additional information such as [configuration properties](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/properties-descriptor-element.md).

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

The following attributes are supported:

| **Attribute** | **Description** | **Required** |
| --- | --- | --- |
| `template` | Identifies the service [template](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-templates.md). | Yes |

All other attributes of the element must correspond to [parameters](https://docs.zeroc.com/ice/3.8/services/icegrid/using-descriptor-variables-and-parameters.md) declared by the template. The `service-instance` element must provide a value for each parameter that does not have a default value supplied by the template.

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

```xml
<icebox id="IceBoxServer" ...>
    <service-instance template="ServiceTemplate" name="Service1">
        <properties>
            <property name="Debug" value="1"/>
        </properties>
    </service-instance>
</icebox>
```

## See Also

- [Service-Template Descriptor Element](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/service-template-descriptor-element.md)
- [IceBox Descriptor Element](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-xml-reference/icebox-descriptor-element.md)
- [IceGrid Templates](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-templates.md)
- [IceBox Integration with IceGrid](https://docs.zeroc.com/ice/3.8/services/icegrid/icebox-integration-with-icegrid.md)
