Super Plugin Sale! Your Choice: BOGO or 30% Off »
Web Dev + WordPress + Security

How to use the HTML <base> tag

[ How to use the base tag ] When every byte counts, you can use the HTML <base> tag to specify a default href and target attribute for all relative URLs on the page. Like a virtual shortcut.

For smaller sites with a flat directory structure, this isn’t going to help much; but for sites with deeply nested directories, the <base> tag can potentially shave a lot of extra weight from your web pages, and also help keep URLs cleaner and shorter.

So if you’re micro-optimizing for performance, the <base> tag can help you out.

Benefits of the base tag

Here are some benefits of using the <base> tag:

  • Reduces page weight
  • Saves bandwidth
  • Shorter URLs
  • Cleaner markup
  • Helps when viewing pages offline
  • Makes migration easier (change one link instead of many)
  • Can make it easier to redirect all relative URLs

Even with these great benefits, not a lot of pages take advantage of the base tag. This might be because the tag is misunderstood and/or not well known, or perhaps it’s because of the potential downsides.

Potential downsides of the base tag

Before using the base tag in your next project, consider these possible downsides:

  • Can cause problems for transparent URL rewrites
  • Can cause problems on some very old browsers

Here is a test and results for base tag and browser support. So really browser support is a non-issue unless you need to support the most archaic of browsers.

That leaves only one real issue that you need to be aware of; if your site is using any sort of transparent rewrite (tip: this is different than a URL redirect), then it’s probably best to avoid the base tag unless you know what you are doing.

Example: Specify the default URL

The technique actually is pretty simple. Let’s look at an example of using the <base> tag to specify the default URL, which will be applied to all relative URLs on the page, including all src and href attributes. This means that the base tag works on images, hyperlinks, iframes, forms, scripts, styles, and any other tag that uses either src or href to reference a URL.

For example, say that you keep all of your images nested deep somewhere, like:

..which as we know can be written as a relative path:


That’s a bit better size-wise, but it’s still gonna add some bytes, especially if multiple images are included on the page. For an entire gallery of images, for example, using that entire path for every image really would pack on the extra weight. Fortunately, we can do much better by specifying a default URL via the <base> tag. To do so, we would add the following code to the head section of our web page(s):

	<base href="">

With that in place, we can exclude the entire path for all of our image files. So instead of doing this for an image gallery:

<img src="/here/is/my/deeply/nested/set/of/images/example-01.jpg" alt="">
<img src="/here/is/my/deeply/nested/set/of/images/example-01.jpg" alt="">
<img src="/here/is/my/deeply/nested/set/of/images/example-03.jpg" alt="">

..we can do this instead:

<img src="example-01.jpg" alt="">
<img src="example-01.jpg" alt="">
<img src="example-03.jpg" alt="">

Depending on the number of images (or whatever files you’re using), the <base> tag can really help reduce page weight and keep markup clean and manageable.

Example: Specify the default target

The <base> tag can also be used to specify the default target attribute for any supportive elements (e.g., links, forms, iframes, et al). For example:

	<base target="_blank" href="">

With that in place, we can exclude the target attribute on our links. So instead of writing this for every link on the page:

<a target="_blank" href="somewhere.html" rel="noopener noreferrer">Example Link</a>

..we can just do this:

<a href="somewhere.html">Example Link</a>

..which further reduces overall page weight. Sure it’s not gonna be huge amount of savings, but every little bit helps when optimizing for performance.

Excluding URLs from the default base value

What if you want to include links or images that are located in a different location than that specified by the <base> tag? Easy. Base works only on URLs that are relative to the base URL. For example, say we reference the following URLs on the page:

Without the <base> tag, these URLs would be treated at face value. So now let’s add a default URL via <base>:

<base href="">

With that in place, our previous example URLs change to this:

Notice how the base value is not applied to the first and second URLs? It’s only applied to the third URL. So to exclude any URL from the base tag, we can simply use an absolute URL, or use a URL that begins with a forward slash, /. Neither of these URLs will be affected by the base tag. So it’s really quite an elegant solution once you understand how it works.

Browser support

The <base> tag is supported by all major browsers, including:

  • Chrome
  • Firefox
  • Opera
  • Safari
  • Internet Explorer


Here are some useful notes on the <base> tag:

  • You must use absolute URLs for fragment identifiers, like #foobar
  • You must use absolute URLs for query-string URLs, like ?foo=bar
  • Always include trailing slash on the base URL (so it’s a directory, not a file)
  • The base tag must be included in the <head> section
  • There can only be one base tag per web page
  • The base tag must specify an href attribute, target attribute, or both
  • Put the base tag before any other tags in the head section in order to use it for script URLs, style URLs, et al

I hope this article helps shed some light on this useful HTML element. If you have experience with <base>, please share in the comments. More information on this tag is welcome :)

About the Author
Jeff Starr = Fullstack Developer. Book Author. Teacher. Human Being.
BBQ Pro: The fastest firewall to protect your WordPress.

2 responses to “How to use the HTML <base> tag”

  1. Great article. Never used this base tag method before.

  2. airos chou 2017/04/26 2:34 am

    Thanks dude, very helpful stuff. i still dont know about this html tag…

Comments are closed for this post. Something to add? Let me know.
Perishable Press is operated by Jeff Starr, a professional web developer and book author with two decades of experience. Here you will find posts about web development, WordPress, security, and more »
BBQ Pro: The fastest firewall to protect your WordPress.
Crazy that we’re almost halfway thru 2024.
I live right next door to the absolute loudest car in town. And the owner loves to drive it.
8G Firewall now out of beta testing, ready for use on production sites.
It's all about that ad revenue baby.
Note to self: encrypting 500 GB of data on my iMac takes around 8 hours.
Getting back into things after a bit of a break. Currently 7° F outside. Chillz.
Get news, updates, deals & tips via email.
Email kept private. Easy unsubscribe anytime.