---
title: "Feature: Navigation links keep the visitor's list choices"
manual: "Academic Profiles"
version: "main"
source: "Changelog/3.0/Feature-ListLinksKeepState.rst"
rendered: "2026-10-02T20:47:49+00:00"
---

# Feature: Navigation links keep the visitor's list choices {#feature-list-links-keep-state}

## Description {#description}

The list action of the list and list-and-detail plugins assigns the new template
variable `activeListArguments`: the choices of the visitor the list is shown
with, as the plugin accepted them - the page while it is not the first, the
letter while one is selected. A query parameter the plugin does not accept from
a visitor never becomes part of it, nor does a value the content element sets,
such as the sorting.

The page navigation `Partials/Profile/List/Pagination.html` and the letter
navigation `Partials/Profile/List/AlphabetPagination.html` build every
link from it through the new view helper `persons:listArguments`, and change
only what the link is responsible for: the page, or the letter, where a letter
link leads to the first page. The list template passes the variable to the
letter navigation, `Partials/Profile/List/ItemList.html` to the page
navigation.

See [What the navigation links carry](../../Templates/Partials/Index.html#templates-navigation-links) and [What the navigation links carry](../../Developers/Index.html#developers-navigation-links).

## Impact {#impact}

The links are the ones they were before: page and letter are still the only
values a visitor sets. A later value - a view mode, a filter - is carried by
both navigations without an edit of theirs.

A project that copied `Pagination.html` or `AlphabetPagination.html`,
or a list template or `ItemList.html` that renders them without
`activeListArguments`, keeps its links, and will drop such a value on the next
click. Adopt the view helper and pass the variable on, as the shipped files do.