Setup & site building · Guide
How to Add Hyperlink in WordPress (Step by Step)

Short answer
Highlight the text in the block editor, click the chain-shaped link icon or press Ctrl+K, then paste a web address or search for one of your own pages and press Enter. The same tool links buttons, images and menu items.
Key takeaways
- Select text, press Ctrl+K or Cmd+K, paste a URL and press Enter.
- Type a page title in the link box to link your own content.
- Use descriptive link text instead of click here.
- Mark paid or affiliate links as sponsored or nofollow.
- HTML anchors let you link to sections on the same page.
How do you add a hyperlink in WordPress?
Highlight the text in the block editor, click the link icon in the toolbar or press Ctrl+K (Cmd+K on Mac), paste or search for the address, and press Enter.
That is the core method, and it works in paragraphs, headings, lists and most text blocks. The same link tool also appears on buttons, images and navigation items.
WordPress lets you link to other websites by pasting a full address, or to your own content by typing a few words of a post or page title. The tool searches your site as you type.
| What you want to link | Where to add the link | Tip |
|---|---|---|
| Words in a paragraph | Link icon in block toolbar | Use clear link text |
| A button | Button block link icon | Keep the label short |
| An image | Image block link icon | Add alt text too |
| A menu item | Navigation block or Menus screen | Use custom links for outside sites |
| A section on the same page | HTML anchor plus # link | Keep anchor names simple |
| An email address | mailto: link | Pre-fill a subject if useful |
Step 1: Select the text you want to link
Click into a block and highlight the exact words that should become the link, usually a short phrase that describes where the link goes.
Good link text tells readers what they will get. Read our pricing guide is better than click here, both for people and for search engines.
The W3C guidance on link purpose explains why descriptive text helps screen reader users, who often jump from link to link.
Keep it short. Linking a whole sentence makes text harder to read and the link harder to spot.
Avoid linking the same words to different pages in one article. Readers expect matching text to lead to the same place.
Step 2: Open the link tool
Click the link icon (it looks like a chain) in the block toolbar, or press Ctrl+K on Windows or Cmd+K on Mac.
A small box appears under the text with a search and address field. If the toolbar is hidden, click the block once to bring it back.
A quicker shortcut: copy a web address, highlight your text, and paste. WordPress turns the selected words into a link to that address in one step.
You can also type two square brackets in some WordPress versions to start a quick link search for your own content. If nothing happens, your version does not support it, and the link icon works just as well.
Step 3: Paste a URL or search your site
Paste a full address starting with https:// for outside sites, or type part of a post or page title and choose it from the suggestions for internal links.
Searching is safer for your own content, because WordPress inserts the correct permalink. If you later change the slug, you still need to update the link, but at least it starts correct.
Press Enter or click the submit arrow to apply the link. The text turns into a link styled by your theme.
Check the link after saving. Hover over it in the editor to see the preview card, which shows the page title or address it points to.
If you pasted an address without https://, WordPress may add http:// or treat it as a relative link. Always paste the full address to be safe.
For tips on linking your own posts to each other, see our guide on adding internal links.
Step 4: Choose whether to open in a new tab
Click the link, open the settings arrow or pencil, and toggle Open in new tab if you want the link to open separately.
WordPress adds the right security attributes for you when this is on. You do not need to add them by hand.
Use new tabs sparingly. They suit long forms or documents where leaving the page would lose progress, but they can confuse people who expect the back button to work.
If you do open a link in a new tab, consider saying so in the text, for example (opens in a new tab). That warns readers who rely on screen readers or the back button.
How do you edit or remove a link?
Click the linked text to show the link preview, then click the pencil icon to change it or the unlink icon to remove it.
Editing keeps the same text and swaps only the address. Unlinking turns the words back into plain text.
Links in reusable blocks or synced patterns update everywhere the pattern appears. Edit them carefully, since one change affects many pages.
If you need to fix many links at once, for example after changing domains, use a search-replace tool rather than editing posts one by one. Back up the database first.
How do you add nofollow or sponsored to a link?
Use the nofollow toggle if your WordPress version or SEO plugin shows one in the link settings, or switch the block to Edit as HTML and add a rel attribute by hand.
Google asks sites to mark paid or affiliate links with sponsored and untrusted links with nofollow. Its page on qualifying outbound links lists the values.
In HTML, a sponsored link looks like this:
<a href="https://example.com/product" rel="sponsored">Example product</a>
Many SEO plugins add nofollow and sponsored toggles to the link box, which avoids editing HTML. Our guide on cloaking affiliate links covers link plugins that set these for you.
How do you link a button or an image?
Select the Button block and click its link icon, or select an Image block, click the link icon and choose a custom URL, media file or attachment page.
Buttons are best for key actions, such as Book a call. Images can link to a larger version, another page or a file.
Do not overuse buttons inside articles. One clear button near the end of a section usually works better than several competing ones.
When linking an image, the alt text acts as the link text for screen readers. Describe where the link goes, not just what the picture shows.
To link a document, upload it first. Our guide on linking to a PDF covers the steps for files.
How do you link to a section on the same page?
Give the target heading an HTML anchor in the block's Advanced settings, then link to that anchor with a # in front of its name.
For example, set the anchor of a heading to pricing. Then link text elsewhere on the page to #pricing.
The page jumps documentation explains this with screenshots. Use lowercase words and hyphens in anchor names.
To link to that section from another page, add the anchor to the end of the full page address.
How do you add links in the classic editor?
In the classic editor, highlight the text, click the chain icon in the toolbar or press Ctrl+K, paste the URL and press Enter or click the apply arrow.
The gear icon opens extra options, including searching your content and opening the link in a new tab.
If you work in the Text tab, you can type the HTML anchor tag directly. The MDN anchor element reference lists every attribute.
How do you add links to menus and email addresses?
Add a custom link in the Navigation block or Appearance > Menus for menus, and use mailto: followed by an address for email links.
Menus can link to pages, posts, categories or any outside address. Our guide on linking a page in a menu walks through both menu systems.
Email links use the same link tool. Our guide on making an email link shows how to pre-fill the subject line.
Why is my link not working?
Most broken links have a typo, a missing https://, a changed slug or a deleted page, and some themes style links so faintly they look broken.
Quick checks:
- Open the link in a private window to see what visitors see.
- Make sure the address starts with https:// for outside sites.
- Check that the target page is still published.
- Clear your cache if the link was just changed.
Run a regular scan with a link checker. Our guide on finding broken links lists tools that do this automatically.
Frequently asked questions
What is the keyboard shortcut for adding a link in WordPress?
Press Ctrl+K on Windows or Cmd+K on Mac after selecting text. The link box opens so you can paste an address or search your site. The same shortcut works in both the block editor and the classic editor.
How do I make a link open in a new tab in WordPress?
Click the link, open its settings with the arrow or pencil icon, and switch on Open in new tab. WordPress adds the needed attributes automatically, so you do not need to edit any HTML yourself.
Can I add a nofollow link without a plugin?
Yes. Switch the block to Edit as HTML and add rel with the value nofollow to the anchor tag. Some WordPress versions and SEO plugins also add a simple toggle in the link settings, which is easier.
How do I link to another page on my own site?
Select the text, open the link tool and type part of the page or post title. WordPress lists matching content. Click the right result and it inserts the correct address for you.
Why does my WordPress link not look like a link?
Your theme controls link styles. Some themes use subtle colours without underlines. Change the link colour in the Site Editor styles or the Customizer, or add a small CSS rule to underline links in content.
Sources
- Page Jumps WordPress.org Documentation
- Qualify your outbound links to Google Google Search Central
- <a>: The Anchor element MDN Web Docs
- Understanding Link Purpose (In Context) W3C
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


