Using contextual links

Add to Standard shortcuts

Goal

Use contextual links to access administrative tasks without navigating the administrative menu.

What are contextual links?

Contextual links give users with the Use contextual links permission quick access to administrative tasks related to areas of non-administrative pages. For example, if a page on your site displays a block, the block would have a contextual link that would allow users with permission to configure the block. If the block contains a menu or a view, it would also have a contextual link for editing the menu links or the view. Clicking a contextual link takes you to the related administrative page directly, without needing to navigate through the administrative menu system.

Steps

  1. Make sure that the core Contextual Links module is installed, and that you have a role with the Use contextual links permission. Optionally, make sure that a toolbar module is installed (either the core Toolbar module or a contributed module replacement).
  2. Visit a non-administrative page on your site, such as the home page.
  3. Locate a block or another area on the page that you want to edit or configure.
  4. Make the contextual links button visible by hovering your mouse over that area in the page. In most themes, this button looks like a pencil and is placed in the upper right corner of the page area (upper left for right-to-left languages), and hovering will also temporarily outline the affected area. Alternatively, click the contextual links toggle button on the right end of the toolbar (left end for right-to-left languages), which will make all contextual link buttons on the page visible until it is clicked again.
  5. While the contextual links button for the area of interest is visible, click the button to display the list of links for that area. Click a link in the list to visit the corresponding administrative page.
  6. Complete your administrative task and save your settings, or cancel the action. You should be returned to the page you started from.

Related topics