Files
nomad/website/content/docs/job-specification/ui.mdx
Aimee Ukasick 986f3c727a Docs: SEO job spec section (#25612)
* action page

* change all page_title fields

* update title

* constraint through migrate pages

* update page title and heading to use sentence case

* fix front matter description

* Apply suggestions from code review

Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>

---------

Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>
2025-05-19 09:02:07 -05:00

51 lines
1.3 KiB
Plaintext

---
layout: docs
page_title: ui block in the job specification
description: |-
The `ui` block adds descriptions and helpful links to a
job page in the Nomad Web UI.
---
# `ui` block in the job specification
<Placement
groups={[
['job', 'ui'],
]}
/>
The `ui` block provides options to modify the presentation of the Job index page
in the Web UI. When specified, a description and any number of links will be
added to the top of the job page in question.
The following will provide the Web UI with a job description and a pair of links:
## Parameters
- `description` `(string: "")` - The markdown-enabled description of the job. We
support [GitHub Flavored Markdown](https://github.github.com/gfm/).
- `link` `(map<string|string>: nil)` - A link that should show up in the header
of the job index page in the Web UI. A job can have any number of links, and
they must contain both a string `label` and `url`.
## Example
```hcl
job "docs" {
ui {
description = "A job that uses **Nomad Variables**"
link {
label = "Learn more about Nomad"
url = "https://developer.hashicorp.com/nomad"
}
link {
label = "Nomad on GitHub"
url = "https://github.com/hashicorp/nomad"
}
}
# ...
}
```
![Job UI links and description rendered in the Web UI](/img/nomad-ui-block.png)