# Metadata

The metadata section allows you to specify further information about your service in a structured way.

## Metadata Properties

| Property              | Type     | Required     |
| --------------------- | -------- | ------------ |
| [name](#name)         | `string` | **Required** |
| [homepage](#homepage) | `string` | Optional     |
| [icon](#icon)         | `string` | Optional     |
| [provider](#provider) | `string` | Optional     |
| [version](#version)   | `string` | Optional     |

### name

A short title typically used in UI representation.

It is allowed to use [parameter substitutions](https://docs.cybus.io/2-0-6/documentation/services/service-commissioning-files/parameters) in this property, for example setting it to `!sub 'Machine ${machineNum}'` if there exists a parameter `machineNum`.

The auto-generated default [Service ID](https://docs.cybus.io/2-0-6/documentation/services/serviceid) will be generated from this string by removing all characters that are not allowed for the Service ID. For backward-compatibility reasons, in Connectware version 1.0.x all characters are changed to lowercase and also all punctuation is removed, including underscore and period.

* **Required**
* Type: `string`
  * maximum length: 80 characters

### homepage

URL to the homepage of the provider

* **Optional**
* Type: `string`
* Format: `uri` – Uniform Resource Identifier (according to [RFC3986](http://tools.ietf.org/html/rfc3986))

### icon

A link to an icon image typically used in UI representation

* **Optional**
* Type: `string`

### provider

The provider/author of the this service commissioning file

* **Optional**
* Type: `string`

### version

Semantic version of the service. The version identifies the capabilities of the service commissioning file. The latest version is 1 and is the only valid value.

{% code lineNumbers="true" %}

```yaml
version: 1
```

{% endcode %}

* **Optional**
* Type: `string`

## Example

{% code lineNumbers="true" %}

```yaml
metadata:
  name: Simulated Machining Center
  icon: http://www.axon-mcs.de/wp-content/uploads/2016/08/Litz-LU620.jpg
  provider: cybus
  homepage: https://www.cybus.io
```

{% endcode %}