Define your namespace

As soon as you will try to create a thing entity, a namespace will automatically be part of its identifier.

In order to separate things from different solution spaces from each other, they are required to be created in a specific namespace. This namespace needs to be provided on each request as a :-separated prefix of the thing ID.
Each thing ID has the form <namespace>:<thing-name>.

  • The namespace must conform to the reverse domain name notation:
    • must start with a lower- or uppercase character from a-z
    • can use dots (.) to separate characters
    • a dot (.) must be followed by a lower- or uppercase character from a-z
    • numbers can be used
    • underscore can be used
  • The namespace is separated by a mandatory colon (:) from the rest of the thing ID.

Examples for a valid thing ID:


The same concept applies to namespaces for other entities:
e.g. policy, topology-schema, and topology.

The user interface Manage your namespace might be helpful in case you need to set or change your “default” namespace.


The easyest way is to use the Manage your solution UI to support you on such tasks.

Example: For the service instance captured in our example screenshot, “org.example.console” is defined as the default namespace.
|Default namespace

The namespace will be used in a configuration file of the application. See cheatsheet for