Chykalophia Docs

Learn how to add hyperlinks to text, buttons, and images in WordPress — including internal links, external links, and how to remove or change a link.

Links are one of the most important things on any website. They connect your content together and send visitors where they need to go. This guide shows you how to add links to text, buttons, and images in WordPress — and how to edit or remove them when needed.

Quick summary

To add a link to text: select the text, click the Link button in the toolbar (it looks like a chain link), paste or type the URL, and press Enter. To link a button, select the button and use the Link button in its toolbar. Links can point to a page on your site or anywhere on the web.

What you'll need

Access to edit a page or post. See how to edit a page if you need a refresher.
The URL (web address) you want to link to. For a page on your own site, you can search by title instead of needing the exact URL.

Add a link to text

This is the most common type of link — a word or phrase that visitors click to go somewhere.

Select the text you want to link. Click and drag to highlight the words. For example, highlight "contact us" to make those words into a link.

Click the link button in the toolbar. The block toolbar appears above the block. Click the Link icon (it looks like two chain links connected). A small input box appears. You can also press Ctrl+K (Windows) or ⌘+K (Mac).

Enter the URL or search for a page. Paste the full web address (starting with https://) or start typing the title of a page on your site — WordPress will search for it and show suggestions. Click a suggestion or paste the URL.

Press Enter or click the arrow button to save the link. The text is now a link.

Include the full URL

When linking to an external website, always include the full address, like https://www.example.com. Current versions of WordPress add https:// if you type just www.example.com, but typing the full address yourself means you know exactly where the link goes.

Open a link in a new tab

Some links should open in a new browser tab — especially links that take visitors away from your site entirely. When you add or edit a link, expand the Advanced section in the link box and turn on Open in new tab. Leave it off to open the link in the same tab.

Don't open every link in a new tab

Opening every link in a new tab can be disorienting for visitors and screen reader users. Use it for links to external websites, documents, or PDFs — not for links to other pages on your own site.

Edit an existing link

Click on the linked text. A small preview popup appears showing the current URL, with buttons to edit (pencil icon), remove (chain-break icon) or copy the link.

Click the pencil icon (Edit link). The link input opens with the current URL filled in.

Change the URL and press Enter or click Apply to save.

Remove a link

Click on the linked text. The link preview popup appears.

Click the chain-break icon (Remove link; it looks like two broken chain links). The link is removed, but the text stays in place.

Add a link to a button

Each button in a Buttons block has its own link setting. You link the whole button, rather than selecting words the way you do in a paragraph.

Click the button to select it. The button text becomes editable.

Click the Link icon in the button's toolbar. A URL input box opens.

Paste or type the URL and press Enter.

Add a link to an image

You can make an entire image clickable.

Click the Image block to select it.

Click the Link icon in the image's toolbar. A link box opens.

Choose where the image should link. For most cases, paste the address you want (or search for a page on your site) and press Enter. The menu can also offer Link to image file, Link to attachment page (for images from your media library) and Enlarge on click, which opens a larger view of the image on the same page.

Internal links vs external links

Type	What it is	Example
Internal link	A link to another page on your own website	`/about` or `https://yoursite.com/contact`
External link	A link to a different website entirely	`https://google.com`
Email link	Opens the visitor's email app	`mailto:hello@example.com`
Phone link	Taps to call on mobile	`tel:+15551234567`

For email and phone links, type the full mailto or tel address in the URL field.

Common questions

My link isn't working — what should I check?

First, if it links to another website, check that the URL starts with https://. Next, copy the URL and paste it into a browser tab to confirm the destination page actually loads. WordPress checks that a link looks like a valid address, but it doesn't check that the page exists. Also check there are no extra spaces before or after the URL in the link field. If you linked to a page on your own site, make sure that page is published and not set to private.

Can I link to a specific section on a page?

Yes — these are called anchor links. You link to a URL that ends with #section-name. Setting up anchors requires adding an HTML anchor to the target block via its advanced settings. Ask your project lead to help set up anchor links if you need them.

How do I make a link open as a download?

Upload the file using the File block — it adds a download button, which you can switch off with Show download button. Alternatively, link directly to the file URL in a text link. Depending on the browser and the file type, a plain link may open the file in the browser instead of downloading it.

The block toolbar can hide while you type. Move your mouse or click the block again to bring it back. Then highlight the words you want to link before clicking Link. If nothing is highlighted, WordPress adds the page title or web address itself as new link text.

Need a hand?

If you're stuck, email support@chykalophia.com and we'll help. Include your website address and a screenshot if you can.

How to add and edit links