Bookmarks: finding your way back, in folders #

This guide explains the My bookmarks page of the administration (/content/bookmark, Dashboard > My bookmarks): what a bookmark is, the overview, the folders, finding, ordering and paging bookmarks, moving them between folders, renaming and removing folders, and what to do when something does not behave as expected.

It is written for editors and administrators. Every page, field and rule below was checked against the code of this repository on 6 October 2026; the files are named in References.

Guides · Related: Bookmark folders (feature) · Bookmark folders (upgrade) · List paging

In short #

• A bookmark points to an item of the content tree. It is personal: nobody else sees your bookmarks, and removing one never changes the item.
• Bookmarks can sit in folders of any depth. The page, the Bookmarks box at the side of every admin page and the browse dialog show the same folders.
• The page shows an overview, the folders with their counts beside the list, and one card per bookmark, grouped by folder, with its type, where it is in the tree, when it was last modified and whether it is hidden or no longer there.
• Search, order and paging are kept in the address, so a link to the page shows the same list.
• In Your order you arrange bookmarks and folders by dragging them by their grip, with the arrow keys on the grip, with Move up and Move down, or with a position field that also works across pages.
• Every action works without JavaScript. With JavaScript you can also tick Select all and drag bookmarks onto a folder.

1. The page #

Open Dashboard > My bookmarks. From top to bottom:

Each card shows:

• a box to select it, the icon of the item's class, its name (a link to the item) and its class;
• Hidden when the item is hidden, Hidden by a parent when an item above it is hidden: visitors of the site do not see it;
• Not found when the item was removed, is in the trash, or is not in a language of this site, and No access when you may no longer read it. Such a card says what to do and shows nothing else of the item;
• the location (the names of the items above it) and when the item was last modified;
• View, Edit (when you may edit it) and, in your own order, Move up and Move down.

2. Finding and ordering #

Find a bookmark searches the names, classes, locations and folder names of your bookmarks, without regard to upper and lower case. On All bookmarks it searches everything; inside a folder it searches that folder and the folders below it. Clear search removes the search; when nothing matches the page says so and offers to search all bookmarks.

The orders:

In every order the bookmarks stay grouped by folder: the ones in no folder first, then the folders in the order of the folder list. Move up and Move down are offered in your own order without a search, so a button never moves a bookmark you cannot see next to.

The page size comes from admininterface.ini [PaginationSettings] ItemsPerPageList_content_bookmark[] (25, 50 and 100 when the setting is not there); your choice is kept as the preference admin_bookmark_list_limit.

3. Adding and moving bookmarks #

• Add items (above the list, or in an empty folder) opens the browse dialog. The items you choose are added to the folder shown; on All bookmarks a new bookmark goes to no folder and an item you had bookmarked already keeps its folder. Items you may not read are not added. The Bookmarks box and the context menu of the content tree add bookmarks too.
• Move: tick the bookmarks, choose the folder under Move the selected bookmarks to and press Move selected. No folder (top level) takes them out of every folder.
• With a mouse you can also drag a bookmark onto a folder in the folder list. If the bookmark is ticked, all ticked bookmarks move with it.
• Remove selected opens a short confirmation first. Only the bookmarks are removed.

Bookmarking a system page #

Pages of the administration itself (System information, the cache page, the help dashboard, the audit trail filtered to a user, a list opened at a page) are bookmarked from the page: Bookmark this page above the breadcrumb, or the same button in the Bookmarks box. The form takes a name (the page title by default) and a folder. A search is bookmarked the same way and keeps its search text. Such bookmarks have the icon of their area (a magnifier for a search), a card with their address, Open and Rename, and are arranged, moved and removed like every other bookmark. They keep no host name and no siteaccess, so they open in every administration of the installation; where a page cannot be opened (switched off in that siteaccess, not allowed by your roles, removed) the bookmark is greyed, without a link, and says why. Pages that only act on a form (saving, removing, signing out, the edit forms) cannot be bookmarked. Step by step, with pictures of every design: Bookmarking system pages; details and settings: Bookmarks of system pages.

4. Arranging bookmarks and folders #

In Your order (without a search) every card has a grip (⠿) at its left, and every folder of the folder list has one too. The order you set is the order of the Bookmarks box and the browse dialog.

• Drag a bookmark by its grip to a new place within its folder. The folder's list is outlined while you drag and the card moves with the pointer; when you let go, the new order is saved and the page shows "The order was saved".
• Drop it on a folder of the folder list instead to move it into that folder. The folder is outlined and labelled Move into this folder, so a reorder and a move are easy to tell apart. Ticked bookmarks move together.
• Folders are arranged the same way: drag a folder's grip above or below a neighbour with the same parent; a line shows where it will go.
• Keyboard: focus a grip with Tab and press the up or down arrow key. The entry moves one place, the page is saved and the grip has the focus again, so you can press the key again.
• Position field: each card has "Position in its folder". Type a number and press Move (or Enter): the bookmark goes to that place in the whole folder, also when the folder runs over several pages.
• Without JavaScript the grips are not shown; Move up, Move down and the position field do the same.

In the other orders (name, recently added, type, recently modified) and while searching, the list cannot be arranged: the page says Switch to Your order to arrange (or to clear the search) and links to it. Dropping a bookmark on a folder of the folder list still moves it there.

5. Folders #

Open a folder in the folder list. Its panel offers:

• Rename: the new name; tags are removed and names are cut at 255 characters.

• Move: the folder to put it in. The folder itself and the folders below it are not offered: a folder cannot go inside itself. Move up and Move down change its place among its neighbours.

• Remove folder says first what happens to what is inside:

  • Keep what is inside (the default): its bookmarks and folders move to the folder it was in (or to the top level), and no bookmark is removed;
  • Remove everything inside with it: the folder, every folder below it and all their bookmarks are removed.

  In both cases the items the bookmarks point to are not changed. After the removal the page shows the folder it was in.

6. Problems and answers #

7. For developers #

• The view is kernel/private/classes/views/content/bookmark.php. It reads the folders and bookmarks (eZContentBrowseBookmarkFolder::fetchRowsForUser()), the nodes of all bookmarks in one query and the names of the items above them in a second, and hands plain arrays to expBookmarkPage.
• expBookmarkPage (kernel/classes/expbookmarkpage.php) works out the folders and their counts, the scope of (folder), the search, the orders, the grouping, the paging, the figures, the Move up and down targets and the address. It reads no database and is tested without one.
• eZContentBrowseBookmarkFolder::shift() moves a folder or a bookmark one place up or down within its folder; setOrder() saves the order of some or all entries of one folder (the posted entries take the places they held, see expBookmarkPage::reorderSlots()), and moveToPosition() puts one entry at a place. Both refuse an id that is not the user's, not in that folder, or repeated.
• Addresses: content/bookmark/(folder)/<id>|top/(sort)/name|added|type|modified/(offset)/<n>/(q)/<text> (view parameters; the search form is sent with POST and answered with a 303 to that address). Every POST answers with a redirect to the same folder, order and search, with the result as a notice.
• The POST names are the ones the page always had: RemoveButton, AddButton, DeleteIDArray[], MoveSelectedButton with FolderID, and BookmarkFolderAction (create, rename, delete, move_bookmark, move_folder, place, reorder) with FolderName, ParentFolderID, FolderID, DeleteBookmarks, BookmarkID, BookmarkIDArray[]. New: BookmarkShiftButton (up-<id>, down-<id>, fup-<id>, fdown-<id>), BookmarkOrderButton with OrderType (bookmark or folder), OrderFolderID and OrderIDs (the ids in their new order, comma separated), and BookmarkPositionButton (the id) with BookmarkPosition[<id>]; BookmarkPositionDefault is the form's first button, so Enter in a position field moves that bookmark.
• Only the user's own bookmarks and folders are read or changed; another user's ids are refused. Every form carries the form token. NeedRedirectBack with RedirectURI goes only to a page of this site (safe redirects).
• The template variables view_parameters and bookmark_notice are kept; the new bookmark_page holds everything else. The tree of the Bookmarks box and the browse dialog (content/bookmark_tree.tpl) is unchanged.
• The look is in the bookmark section of stylesheets/modules/content.css (design/admin and design/admin4), in the visual language of the section, link list and session pages.
• A system page bookmark keeps its address (expbookmark_view.module_uri) and the same address taken apart: module_name, view_name and view_parameters (expBookmarkView::parse()). When a module or a view is renamed, php update/common/scripts/6.0/createbookmarkviewtable.php --rename=<old>=<new> moves the bookmarks of every user (details).

Tests, no database: php vendor/bin/phpunit tests/tests/kernel/classes/bookmarks/expBookmarkPageTest.php. With an installation: php vendor/bin/phpunit tests/tests/kernel/classes/bookmarks/BookmarkFoldersTest.php --filter 'testShift|testSetOrderAndMoveToPosition'.

References #

• kernel/private/classes/views/content/bookmark.php, kernel/classes/expbookmarkpage.php, kernel/classes/ezcontentbrowsebookmarkfolder.php, kernel/classes/ezcontentbrowsebookmark.php
• design/admin4/templates/content/bookmark.tpl, design/admin4/stylesheets/modules/content.css (the same in design/admin)
• tests/tests/kernel/classes/bookmarks/expBookmarkPageTest.php, tests/tests/kernel/classes/bookmarks/BookmarkFoldersTest.php
• Changelog 6.0.15