Skip to content

Mention ability to define several sitemaps in a file #2714

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lolodomo wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Mention ability to define several sitemaps in a file #2714

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
71342f1
Mention ability to define several sitemaps in a file
lolodomo May 5, 2026
01baffd
Update sentence about number of sitemap definitions
lolodomo May 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 5 additions & 4 deletions ui/sitemaps.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,8 @@ This page is structured as follows:

[[toc]]

Sitemaps are text files with the `.sitemap` extension, and are stored in the `$OPENHAB_CONF/sitemaps` directory.
Sitemaps are text files with the `.sitemap` or `.sitemaps` extension, and are stored in the `$OPENHAB_CONF/sitemaps` directory.
They can now contain any number of sitemap definitions.
Sitemaps follow the syntax described in this article.

For easy editing of sitemap definition files, we suggest to use one of the [openHAB supporting editors]({{base}}/configuration/editors.html).
Expand Down Expand Up @@ -111,13 +112,13 @@ The `sitemap` element is **mandatory** in a Sitemap definition.
This element shall be the first line in the sitemap file, and the following code block comprises the entire Sitemap definition.

```java
sitemap <sitemapname> label="<title of the main screen>" {
sitemap <sitemapname> [label="<title of the main screen>"] {
[all sitemap elements]
}
```

- `sitemapname` shall always be equal to the Sitemaps file name, e.g. the `sitemapname` in a sitemap file named `demo.sitemap` must be "demo"
- `label` is free text and will be shown as the title of the main screen.
- `sitemapname` is the identifier of the Sitemap definition.
Comment thread
lolodomo marked this conversation as resolved.
- `label` is an optional free text and will be shown as the title of the main screen.
Comment thread
lolodomo marked this conversation as resolved.

(Note that the element `sitemap` is written with a lower case "s".)

Expand Down