Link anchors and URL types | Civio CMS Knowledge Base [ ![Civio Knowledge Base](/storage/branding/01KP4QF0THM695BDF2MG6TX3CY.svg) ](https://nginx.deploy-lagoon-production.districtcms-docs.dh1.amazee.io) [Articles](/articles) [Releases](/releases) [Home](/) [Knowledge base](/articles) [Page building & display](/articles?category=6) Link anchors and URL types ========================== Updated 2 weeks ago Search Go Overview -------- Ever wanted to link to a specific part of a page, or wondered what the difference is between all the link types? You're in the right place! This article covers two related linking topics in District: how to create and use link anchors to navigate to specific sections of a page, and when to use absolute vs relative URLs when creating links. Link anchors ------------ Anchors let you link directly to a specific section of a web page — useful for long pages where you want users to jump straight to a particular part without scrolling. ### Creating an anchor You can manually create a named anchor at any point on a page using the WYSIWYG editor. 1. In the WYSIWYG editor, place your cursor where you want to create the anchor. 2. Click the **Anchor** button in the toolbar. 3. In the dialog box that appears, enter a short, descriptive name for your anchor (e.g. `top-of-page`). 4. Click **OK**. A small anchor icon will appear at the point you placed it. ![](/storage/t9jBSecm48HeFRFRV1YWJwY8a98TDB1BrF87NAvw.png) ### Linking to an anchor Once an anchor exists on a page, you can link to it from anywhere on your site. 1. Select the text you want to turn into a link. 2. Click the **Link** button in the WYSIWYG editor. 3. In the URL field, type a `#` followed by the anchor name (e.g. `#top-of-page`). 4. Click **OK**. When a user clicks that link, they'll be taken directly to the anchor point on the page. ### Automatic anchors for headings District also automatically generates anchor links for every H2–H6 heading on a page — no manual setup needed. To copy one: 1. Navigate to the page containing the heading you want to link to. 2. Click the **\#** (hashtag) that appears at the end of the heading element. 3. The browser URL will update to include the anchor (e.g. `/page-name#section-title`). 4. Copy the updated URL from the browser address bar and use it wherever needed. Absolute vs relative URLs ------------------------- ### Absolute URLs An absolute URL is a complete web address that specifies the exact location of a resource. It includes: - **Protocol** — e.g. `http` or `https` - **Domain name** — e.g. `www.example.com` - **Path to the resource** — e.g. `/about/our-team` Example: `https://www.example.com/about/our-team` ### Relative URLs A relative URL is a partial web address that provides a path to a resource relative to the current site. It omits the protocol and domain name, making it shorter and easier to manage. Example: `/about/our-team` Relative URLs are useful, as they adapt to the structure of the site and will always be relative to the domain. Relative URL's will always append the resource or page path to the domain URL. Relative URLs are the preferred method of referencing paths, as it will append the resource path to the end of the domain URL. Absolute URLs should be used when referencing external sites. All internal referencing paths should use relative paths over Absolute URLs. **URL Types** ------------- When you create a link in District, you'll see a few different URL types to choose from. Here’s what they all mean: - **Internal:** Use this to link to other content within your District site. You can search for the page by its title, which is super handy. This is the best way to link to your own content as it prevents broken links if the URL of the page changes. - **External:** Use this for any URL that is outside of your website. Just paste the full web address, including the `https://`. - **Email:** This will create a 'mailto' link that opens the user's default email client. Just enter the email address you want the email to be sent to. - **Telephone:** This creates a link that will start a phone call on a mobile device. Enter the phone number, including the area code. That's it! You're now a pro at creating link anchors and using the different URL types in District. For more tips on using the editor, see **Using the WYSIWYG editor**. > **💡 Best practice:** Relative URLs are the preferred method for linking to content within your District site. They automatically append the resource path to your domain URL, meaning internal links will continue to work correctly even if your domain changes. Use absolute URLs only when linking to external websites. [ Back to articles ](/articles) Table of contents ----------------- © 2026 [District CMS](https://www.district.au)