---
title: "Important: Letters without profiles are disabled in the letter navigation"
manual: "Academic Profiles"
version: "main"
source: "Changelog/3.0/Important-LetterNavigationMarkup.rst"
rendered: "2026-09-23T01:52:11+00:00"
---

# Important: Letters without profiles are disabled in the letter navigation {#important-letter-navigation-markup}

## Description {#description}

The letter navigation of the profile list and list-and-detail plugins linked
every letter from A to Z, so a visitor could land on a page that said no
profiles were found. The shipped partial
`Partials/Profile/List/AlphabetPagination.html` now reads which letters
lead somewhere (see [Feature: The letter navigation knows which letters lead somewhere](Feature-LetterNavigationAvailability.html#feature-letter-navigation-availability)) and renders:

-   a letter with profiles as a link, as before;
-   a letter without profiles as `li.page-item.disabled` with a
    `span.page-link` and no link, plus a visually hidden "no profiles" for
    assistive technology;
-   the selected letter as `li.page-item.active` with
    `aria-current="page"`, not linked, as before;
-   **A-Z** as `li.page-item.active` with
    `aria-current="page"` while no letter is selected.

The `<nav>` gets an `aria-label` from the new label
`list.alphabetFilter.navigation`, and `list.alphabetFilter.noProfiles` is the
hidden text of a disabled letter, both in English and German.

## Impact {#impact}

A list with the letter navigation shows the letters without profiles greyed out
by Bootstrap's `.disabled`, and they can neither be clicked nor reached
with the keyboard. **A-Z** is highlighted while no letter is selected.

A project stylesheet that styles `.alphabetical-pagination .page-link` as
a link may need a rule for the new `span.page-link` of a disabled letter.

A project that overrides `Partials/Profile/List/AlphabetPagination.html`
keeps its markup and shows no availability until it reads
`alphabetFilterLetters`. A project that overrides
`Templates/Profile/List.html` and renders the shipped partial with
`demand` alone gets every letter as a link, as before; to get the disabled
letters it passes `alphabetFilterLetters` along:

```html
<f:render
    partial="Profile/List/AlphabetPagination"
    arguments="{demand: demand, alphabetFilterLetters: alphabetFilterLetters}"
/>
```

## Affected Installations {#affected-installations}

Every installation with a profile list or list-and-detail plugin that has the
letter navigation switched on.
