Place Links

This guide explains how to create various types of links within your content. It helps beginners understand that a link is more than just a URL; it’s a tool for navigation. You’ll learn how to use the Multi-URL Picker to link to internal pages, external websites, or media files like brochures and menus.

The Multi-URL Picker

The Multi-URL Picker is the standard tool in Umbraco 17+ for managing links. Instead of manually typing in web addresses (which can lead to typos and broken links), this tool allows you to:

  • Search your Content Tree: Pick a page directly from your site. If you move that page later, Umbraco automatically updates the link so it doesn't break.

  • Link to Media: Select a file from your Media Library (like a PDF or Word doc).

  • External Links: Paste a URL for a different website entirely.

  • Anchor Links: Link to a specific section on a page.

Link Behavior: Same vs. New Tab

When placing a link, you have the option to set the Target.

  • Same Tab (Default): Best for internal links. It keeps the user on your journey.

  • New Tab (_blank): Essential for external links. This ensures that when the user closes the external site, your website is still open in their browser.

Watch: Master the Multi-URL Picker in Umbraco 17+

Blank placeholder image

This video shows how to add buttons, text links, and how to manage multiple links in a single list.

Other Related Tutorials

Action Steps to Place a Link

  1. Locate the Link Field: Look for a button labeled "Add Link" or the link icon in a text editor.

  2. Choose Your Type: * Internal: Navigate the tree and click the desired page.

    • Media: Click the 'Media' tab to choose a file.

    • External: Paste the full URL (including https://) into the URL box.

  3. Enter "Link Title": This is the text the user actually clicks on (e.g., "Read Our Story" rather than "Click Here").

  4. Set the Target: Check the box for "Open in new window" if you are linking to an external site or a PDF.

  5. Submit and Publish: Click Submit to close the picker, then Save and Publish your page.

 

Pro-Tip: Avoid using "Click Here" as your link title. Descriptive links like "Download our 2026 Price List" are much better for SEO and help people using screen readers understand exactly where the link is going before they click it.

Where Next?

Now that your links are guiding visitors perfectly, why not provide them with valuable downloadable resources? Your next step is to explore "Link to a (PDF) File".