---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.3
alternate:
  - https://diplodoc-platform--docs.viewer.diplodoc.com/en/project/leading-page.md
  - https://diplodoc-platform--docs.viewer.diplodoc.com/ru/project/leading-page.md
  - href: en/project/leading-page.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
updatedAt: '2026-08-11T13:35:17.000Z'
---
> **Documentation Index:** Fetch the complete configuration index at https://diplodoc-platform--docs.viewer.diplodoc.com/en/llms.txt

# Landing page

For quick navigation through the document, you can design the page as a grid with links to the main sections.

Example: design of a leading page [for the Yandex Compute Cloud service documentation](https://cloud.yandex.ru/docs/compute/).

![Example of a leading page](../_images/leading.png)

## Structure {#structure}

The standard structure of the leading page YAML file is as follows:

```yaml
title: Имя документа
description: Описание документа
meta:
  title: Метаданные
  noIndex: true
links:
- title: Первый раздел
  description: Описание первого раздела
  href: path/to/file
- title: Второй раздел
  description: Описание второго раздела
  href: path/to/file
```
* `title` — document title. It is displayed in the table of contents above the list of all sections.
* `description` — document description.
* `meta` — [metadata](https://diplodoc-platform--docs.viewer.diplodoc.com/en/project/meta.md).
* `links` — grouping element. For each section within it, the following is specified:
    * `title` — section title. Displayed as the link name.
    * `description` — section description.
    * `href` — relative path to the file without specifying the extension.

Document and section descriptions **do not support** Markdown markup.

## Opening links in a new tab {#target}

By default, all relative links on the leading page open in the current browser tab, while all absolute links open in a new tab. This behavior can be changed using the `target` parameter:

* `_self` — the link will open in the current tab,
* `_blank` — the link will open in a new tab.

```yaml
- title: Абсолютная ссылка
  href: https://github.com
  target: _self
- title: Отдельный раздел в документации
  href: ./some-internal-page/
  target: _blank
```

## Element visibility conditions {#when}

Individual sections can be shown or hidden on the leading page depending on the values of [variables](https://diplodoc-platform--docs.viewer.diplodoc.com/en/syntax/vars.md). The `when` parameter is used to describe visibility conditions.

Available comparison operators: `==`, `!=`, `<`, `>`, `<=`, `>=`.

```yaml
- title: Раздел с условным вхождением
  description: Описание раздела
  href: path/to/conditional/file.md
  when: version == 12
```

## Substitutions and conditional operators {#subtitudes}

The title and description of the document and links support [substitutions](https://diplodoc-platform--docs.viewer.diplodoc.com/en/syntax/vars.md#subtitudes) and [conditional operators](https://diplodoc-platform--docs.viewer.diplodoc.com/en/syntax/vars.md#conditions).

```yaml
title: "{{ title }}"
description: "{% if version == 10 %}{{ description_legacy }}{% else %}{{ description }}{% endif %}"
meta:
  title: "{{ meta_title }}"
links:
- title: "{{ link_title }}"
  description: "{{ link_description }}"
  href: path/to/conditional/file.md
```

> See also: [Ajv schema for leading pages](https://raw.githubusercontent.com/diplodoc-platform/ajv/refs/heads/master/src/json/frontmatter-schema.json)