How to force links to open in a new window
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
The information on this page relates to customizations. Consequently, Atlassian Support cannot guarantee to provide any support for the steps described on this page as customizations are not covered under Atlassian Support Offerings. Please be aware that this material is provided for your information only and that you use it at your own risk.
A feature request has been created at CONFSERVER-11194 - Open links in new window, for interested parties. For more information on how new features are implemented, please see our Implementation of New Features Policy.
A 3rd party plugin is available that reproduces some of this functionality.
By default, links are opened in the same window. To force them to be opened in a new window, follow these steps:
Solution
Workaround
This customization will only work for Confluence 3.0.1 and above
Logged into Confluence as an administrator, in the top-right corner click Settings > General Configuration > Custom HTML
Click Edit
In the
At end of the HEADfield, insert this code:For external links only, like
[http://www.google.com]:1 2 3 4 5<script> jQuery(document).ready(function() { jQuery(".external-link").attr("target", "_blank"); }); </script>For all types of links (internal and external):
1 2 3 4 5<script> jQuery(document).ready(function() { jQuery(".wiki-content a").attr("target", "_blank"); }); </script>For including 'Live Search macro' result links on top of all types of links
1 2 3 4 5 6 7 8 9 10 11 12 13<script> jQuery(document).ready(function() { jQuery(".wiki-content a").attr("target", "_blank"); }); AJS.toInit(function($) { AJS.$(document).bind('DOMNodeInserted', function(event) { if ( $(event.target).is(".search-macro-dropdown") ) { AJS.$("div.wiki-content a").attr("target", "_blank"); } }); }); </script>
Hit Save
If you'd like to use this functionality on a single page rather than the whole instance, enable the HTML Macro and embed this script in your page.
Keyboard Hotkey
On the other hand, user can also use the keyboard hotkeys below while clicking on a link that should work on most browsers:
Function | Windows Hotkey | Mac Hotkey |
|---|---|---|
Open in New Tab | Ctrl + Click | ⌘ + Click |
Open in New Window | Shift + Click | Shift + Click |
Was this helpful?