support.atlassian.com Open in urlscan Pro
108.138.7.94  Public Scan

Submitted URL: https://click.e.atlassian.com/?qs=38ec64583b0c12989c4a792ce1d36c6190d9435c55aeed01b2768f522bb2b89ac1165fcee610ad0838cd85410b60...
Effective URL: https://support.atlassian.com/confluence-cloud/docs/insert-links-and-anchors/?utm_source=product-announcement-email&utm_medium...
Submission: On July 15 via manual from NL — Scanned from NL

Form analysis 0 forms found in the DOM

Text Content

CONFLUENCE SUPPORT

 * Products
 * Documentation
 * Resources

 * Contact
 * 
 * Log in
 * 

 * 
 * Log in
 * 

Cloud
Data Center
 * Jira Software
 * Jira Service Management
 * Jira Work Management
 * Jira Align
 * Confluence
 * Trello
 * Bitbucket
 * Opsgenie
 * Statuspage
 * Platform experiences
 * Halp
 * Advanced Roadmaps for Jira
 * Team Calendars
 * Questions for Confluence
 * Atlassian Cloud
 * Atlassian Analytics
 * Compass
 * Jira Product Discovery

 * Considering Confluence Cloud?
   
   Get the high-level details of Confluence Cloud and available features by
   plan.

 * Create and organize work in Confluence Cloud
   
   Learn how to create great content and organize it.

 * Collaborate on content and get notified in Confluence Cloud
   
   Learn how to collaborate on pages and blogs, get notified about activity, and
   view analytics to see how content is performing.

 * Manage your account and permissions in Confluence Cloud
   
   Adjust your personal settings in Confluence Cloud

 * Extend the functionality of Confluence Cloud
   
   Get an overview of the macros and premium features that extend Confluence
   functionality.

 * Space administration
   
   Find everything space administrators needs to know to set up and manage their
   spaces in Confluence Cloud.

 * Confluence administration
   
   Find everything a Confluence admin needs to know to keep a Confluence Cloud
   instance running smoothly.

 * Atlassian administration for Confluence Cloud
   
   Atlassian administration pertaining to Confluence Cloud

 * Community
   
   Answers, support and inspiration

 * System Status
   
   Cloud services health

 * Suggestions and bugs
   
   Feature suggestions and bug reports

 * Marketplace
   
   Product apps

 * Billing & licensing
   
   Frequently asked questions

Products
Documentation
Resources
 * Log in to account
 * Contact support
 * Training & Certification
 * Atlassian Migration Program
 * GDPR guides
 * Enterprise services
 * Atlassian Partners
 * Developers
 * Success Central
 * User groups
 * Automation for Jira
 * Atlassian.com

Confluence Cloud

Documentation

 * 
   Considering Confluence Cloud?
   * 
     Confluence Cloud functionality and features
     * What is Confluence Cloud?
     * Learn about the features of Confluence Cloud plans
     * Confluence Standard
   * 
     See how teams use Confluence Cloud
     * Use Confluence for technical documentation
     * Use Confluence for software teams
 * 
   Create and organize work in Confluence Cloud
   * 
     Navigate around Confluence
     * Use Home to jump into work and see what's happening
     * Confluence navigation
   * 
     Use spaces to organize your work
     * Create a blank space
     * Create a space from a template
     * Choose a space key
     * Customize your personal space
     * Navigate spaces
     * Organize your space
     * Find content in a space
     * Customize your space's overview
     * Use labels to categorize spaces
     * Customize your space
   * 
     Find content in Confluence Cloud
     * Search for pages, posts, and other items
     * Search the people directory
     * Confluence search syntax
     * Discover relevant content with related pages
     * Use Atlassian Intelligence to search for answers
   * 
     Create and edit content
     * Create, edit, publish, and update a page
     * Format a page or blog with a template
     * Use Atlassian Intelligence to help write or edit content
     * Format your page
     * 
       Smart Links in Confluence
     * What data is sent and received when pasting a Smart Link?
     * Bring all your work into Confluence
     * Insert elements into a page
     * Use symbols, emojis, and special characters
     * Make your page and its title more memorable
     * Add a status to your page or blog
     * View a page
     * Keyboard shortcuts and autocomplete
     * Available markdown commands
     * Import external documents
     * Transfer ownership of your page to another person
     * What is the new and improved publishing experience?
     * Convert pages to the cloud editor
     * Classify content
   * 
     Keep content organized
     * Take quick action from the content title
     * Use labels to organize pages and attachments
     * Move, copy, and hide content items
     * Archive content items
     * Restore archived items to the content tree
     * Delete, restore, or purge a content item
     * Save a page or other content item for later
   * 
     Upload and manage files
     * Upload a file
     * Display files and images
     * Manage uploaded files
     * Share and comment on files
   * Present your content with Presenter mode
   * 
     Atlassian Intelligence features in Confluence Cloud
     * Search for answers using Atlassian Intelligence
     * Write or edit content using Atlassian Intelligence
     * Summarize a page or blog using Atlassian Intelligence
     * Define terms using Atlassian Intelligence
     * Use Atlassian Intelligence with Confluence automation
     * Learn about pre-defined prompts in Atlassian Intelligence
     * Summarize comments using Atlassian Intelligence
   * 
     Use Loom in Confluence Cloud
     * Enable Loom in Confluence for your team
   * 
     Create and edit whiteboards
     * Getting started with Confluence whiteboards
     * Create a new whiteboard
     * Navigation tools in whiteboards
     * Organize and explore ideas with sticky notes
     * Use shapes to visualize ideas
     * Add and edit text on whiteboards
     * Build flows and diagrams with flows and connectors
     * Inserting links to your whiteboard
     * Use sections to organize your work
     * Add and edit images on whiteboards
     * Add the feels with stamps and stickers
     * Use a template to get started fast
     * Keep on track with the timer
     * Hide collaborator cursors
     * Integrate whiteboards into your Atlassian workflow
     * Link Jira issues from your whiteboard
     * Take bulk Jira actions with smart sections
     * Set your whiteboard preferences
     * Import Figjam boards in Confluence whiteboards
     * Import Miro boards in Confluence whiteboards
     * Import Mural boards in Confluence whiteboards
     * Import Jamboard whiteboards in Confluence whiteboards
     * Export your whiteboard
     * Collaboration limits on whiteboards
     * What Confluence whiteboards don't support
     * Whiteboards impact on third-party apps
     * Understand Confluence whiteboards plans and features
     * Browser support and settings for whiteboards
   * 
     Create and edit databases
     * Get started with Confluence databases
     * Database tour
     * Create a database
     * Database fields
     * Share databases, entries, or values
     * Database views
     * Layouts and options
     * Filter your data
     * Sort fields
     * Hide fields in your database
     * Import data into your database
     * Export your database data
     * Duplicate a database setup
     * Lock your database structure
     * What Confluence databases don't support
     * Database impact on third-party apps
   * Create and collaborate on live-edit pages in Confluence
   * 
     Export content from Confluence Cloud
     * Wide tables may be cut off in PDF export
     * Cases where PDF Export may revert to using legacy exporter
 * 
   Collaborate on content and get notified in Confluence Cloud
   * 
     Collaborate on content
     * Create a network of users
     * Add a reaction to any content
     * Mention a person or team
     * Share a page, whiteboard, or blog post
     * Comment on pages, whiteboards, and blog posts
     * Watch pages, spaces, whiteboards, and blogs
     * Add people to Confluence from Google, Slack, or Microsoft
     * What can guests see and do in Confluence?
     * Share content externally with public links
   * 
     Get notified about content and activity
     * View your notifications
     * Subscribe to email notifications
     * What is a Confluence RSS feed?
     * Build an RSS feed
     * Subscribe to pre-specified RSS feeds
     * Subscribe to a network RSS feed
   * 
     View Confluence analytics to see how content is performing
     * View insights on your site
     * View insights on spaces
     * Page insights and analytics
 * 
   Manage your account and permissions in Confluence Cloud
   * 
     Manage your account
     * Edit your profile
     * Edit your user settings
     * Change your Confluence password
     * Manage OAuth access tokens
     * Delete your account
     * Change your theme
     * Set your email visibility
   * 
     Manage permissions on the page level
     * Add or remove content restrictions
     * Confluence permissions structure
 * 
   Extend the functionality of Confluence Cloud
   * 
     Use macros to show Confluence content on pages
     * What are macros?
     * Learn which macros are being removed
     * Insert the attachments macro
     * Insert the blog posts macro
     * Insert the Change History macro
     * Insert the child pages macro
     * Insert the filter by label macro
     * Insert the content report table macro
     * Insert the contributors macro
     * Insert the contributors summary macro
     * Insert the create from template macro
     * Insert the decision report macro
     * Insert the excerpt macro
     * Add excerpts to a page with the insert excerpt macro
     * Insert the include page macro
     * Insert the labels list macro
     * Insert the network macro
     * Insert the popular labels macro
     * Insert the profile picture macro
     * Insert the recent updates macro
     * Insert the recently updated dashboard macro
     * Insert the related labels macro
     * Insert the spaces list macro
     * Insert the task report macro
     * Insert the user profile macro
   * 
     Use macros to add development info on Confluence pages
     * Insert the code block macro
     * Display Jira issues in a list
     * Insert the Jira chart macro
     * Insert the Jira timeline macro
     * Display your Assets data on a Confluence page
   * 
     Use macros to include media on Confluence pages
     * Insert the Google Drive macro
     * Insert the Microsoft OneDrive for Business macro
     * Insert Microsoft Office macros
     * Insert the multimedia macro
     * Insert the PDF macro
     * Insert the widget connector macro
   * 
     Use macros to add navigation on Confluence pages
     * Insert the anchor macro
     * Insert the Live search macro
     * Insert the navigation map macro
     * Insert the page index macro
     * Insert the page tree macro
     * Insert the page tree search macro
     * Insert the table of contents macro
     * Insert the table of content zone macro
   * 
     Use macros to add reporting info to Confluence pages
     * Insert the page properties macro
     * Insert the page properties report macro
     * Insert the user list macro
   * 
     Use macros to add visuals and images to Confluence pages
     * Insert the chart macro
     * Insert the gallery macro
     * Insert the iFrame macro
     * Insert the roadmap planner macro
     * Add a trio of dynamic frames to your page with Carousel
     * Display beautiful, dynamic content on your page with Cards
   * 
     Review macros only available in the legacy editor
     * Insert the cheese macro
     * Insert the column macro
     * Insert the content by user macro
     * Insert the create space button macro
     * Insert the expand macro
     * Insert the favorite pages macro
     * Insert the global reports macro
     * Insert the IM presence macro
     * Insert the info, tip, note, and warning macros
     * Insert the JUnit report macro
     * Insert the noformat macro
     * Insert the panel macro
     * Insert the recently used labels macro
     * Insert the search results macro
     * Insert the section macro
     * Insert the space attachments macro
     * Insert the space details macro
     * Insert the status macro
     * Insert the lorem ipsum macro
   * 
     Use gadgets to add dynamic content
     * Add the activity stream gadget
   * 
     Use Confluence with other applications
     * Use Slack and Confluence together
     * Use Jira and Confluence together
     * Use Trello and Confluence together
     * Use Microsoft Teams and Confluence together
   * 
     Use Team Calendars for Confluence (Premium feature)
     * Subscribe to Team Calendars from third-party calendars
     * Getting started with team calendars
     * Add events
     * Add Jira events
     * See standard event types
     * Add and delete custom event types
     * Add reminders to events
     * Embed calendars on Confluence pages
     * Watch a calendar
     * Subscribe to Team Calendars from Apple Calendar
     * Subscribe to Team Calendars from Thunderbird
     * Subscribe to Google Calendars from Confluence
     * Subscribe to Team Calendars from Google Calendar
     * Subscribe to Team Calendars from Microsoft Outlook
     * Subscribe to Team Calendars from Apple iOS Calendar
     * Export to other calendars
     * Set system properties
     * Team Calendars FAQs
     * Subscribe to Team Calendars from Google Calendar (Android)
   * 
     Use Questions for Confluence
     * Install Questions for Confluence
     * Ask a question
     * Watch and edit topics
     * What are votes and experts?
     * Admin settings for Questions for Confluence
   * Use automation for Confluence (Premium feature)
   * Create and customize a company hub
 * 
   Space administration
   * 
     Set space-specific functionality
     * Advanced PDF export customizations
     * Set a default classification level for content
   * 
     Manage permissions at the space level
     * What are space permissions?
     * Copy space permissions
     * Assign space permissions
     * Make a space public with anonymous access
     * Assign Questions for Confluence permissions
   * 
     Manage content in a space
     * Clean up a space with the content manager
     * Transfer ownership of a page from one user to another
     * Manage page watchers
     * Export a space's content as Word, PDF, or data files
   * 
     Remove a space
     * Archive a space
     * Delete a space
   * 
     Create page templates, blueprints, and reports
     * Create a template
     * Edit a template
     * Promote a template
     * Delete or disable a template
     * Create a custom report
   * 
     Manage team calendars
     * Delete or remove a calendar
     * Restrict a calendar
   * 
     Manage Questions for Confluence
     * Get started with Questions for Confluence
     * Administer questions
     * Integrate questions with your spaces
 * 
   Confluence administration
   * Get started as Confluence Cloud administrator
   * 
     Set Confluence-wide functionality
     * Control whether spaces can allow public links
     * Control whether spaces can turn on anonymous access
     * Change the landing page of the Home tab
     * Change the Confluence Home welcome message
     * Create a custom space overview template
     * Turn off page reactions
     * Customize layout for PDF exports in Confluence Cloud
     * Convert legacy pages in all spaces
     * Enable Loom in Confluence
   * 
     Monitor and manage activity in Confluence Cloud
     * Act on insights from mission control
     * View the audit log
   * 
     Premium admin tools for Confluence Cloud
     * Post Confluence-wide announcements in a banner
     * Confluence automation for premium plans
     * Inspect a user's permissions
     * Bypass page restrictions with admin key
   * 
     Manage global permissions in Confluence administration
     * What is a Confluence group?
     * Manage global permissions
     * Assign space access to guests
     * Manage public links across Confluence Cloud
     * How secure are public links?
     * Give access to unlicensed users from Jira Service Management
   * 
     Manage analytics permissions in Confluence administration
     * Control which groups can use analytics
   * 
     Manage Confluence page templates
     * Create a global page template
     * Edit a global page template
     * Install a global blueprint
     * Manage global page templates and blueprints
   * 
     Configuration settings in Confluence Cloud
     * Change the site title
     * Configure the administrator contact page
     * Choose a default language
     * Configure the indexing language
     * Configure time and date formats
     * Configure number formats
     * Configure attachment size
     * Configure shortcut links
     * Install a custom language font for PDF exports
     * Confluence wiki markup syntax for the legacy editor
     * Customize the email domain sending Confluence emails
   * 
     Security settings in Confluence Cloud
     * Hide external links from search engines
     * Disable anonymous access to remote API
     * Turn on Captcha for spam prevention or failed logins
   * 
     Look and feel settings in Confluence Cloud
     * Install a theme
     * Set the default theme
     * Customize the color scheme
     * Change your site and space logos
   * 
     Data management in Confluence Cloud
     * Import a Confluence Cloud space
     * Export a data backup file of your instance
     * Migrate a Confluence Cloud instance or merge instances from multiple
       sites
     * Migrate from Confluence Cloud to Data Center
   * 
     Atlassian Marketplace apps
     * Manage your apps
 * 
   Atlassian administration for Confluence Cloud
   * 
     Actions that require an organization or site admin
     * Manage your storage usage
     * Invite guests to Confluence
     * Removing users and downgrading to Confluence Free
     * Adjust permissions before downgrading to Confluence Free
     * What happens when an account is deactivated vs. deleted?

Atlassian Support
/
Confluence
/
Resources
/
Create and organize work in Confluence Cloud
/
Create and edit content
Cloud
Data Center




SMART LINKS IN CONFLUENCE

Smart Links make it easy to create, edit, and view work across Atlassian and
third-party products. With Confluence, Jira, and other Atlassian products, every
link is a Smart Link.



Smart Links allow you to create and interact with links to:

 * Hover over links to display rich information and interact with link elements
   like changing the status of Jira issues

 * Control how links appear in pages you create with dynamic display options

 * Collaborate on tasks and projects without leaving the Confluence page

Most links (also known as hyperlinks and URLs) will automatically unfurl or
convert into a Smart Link when you paste them in a Confluence page.

You can cancel this by using keyboard shortcuts:

 * For Mac: Cmd + Z   

 * For Windows: Ctrl + Z

You can also select the link and choose your preferred display view from the
Smart Link toolbar.


CREATE AND INSERT LINKS

Highlight words or phrases then use Cmd + K for Mac or Ctrl + K for Windows to
convert them into links. You may also select the link icon from the top menu.


LINK TO HEADINGS OR SECTIONS

To insert a link leading to a specific heading or section of a page:

 1. Hover over the heading until the link icon appears.

 2. Select the link icon. This will copy the URL of the heading link.

 3. Use the URL you copied to create the link.




LINK TO A CONFLUENCE COMMENT

To insert a link leading to a comment from Confluence page:

 1. Hover over the comment date until the link icon appears.

 2. Select the link icon. This will copy the URL of the heading link.

 3. Use the URL you copied to create the link.




LINK TO AN EMAIL ADDRESS

To insert a link that will create a message directed to a specific email
address:

 1. Use Cmd + K for Mac or Ctrl + K for Windows, or select the link icon(icon).

 2. Type ‘mailto:’ followed by the email address in the link field. For example:
    'mailto:iamawesome@email.com'

 3. Choose the text to display.

 4. Select Insert.




LINK TO AN ANCHOR

To link to an Anchor macro on the same page:

 1. Make note of the name of the anchor to which you want to link. The name is
    displayed on the anchor when editing the page.

 2. Highlight the text you want to use as the link.

 3. Select the link tool .

 4. Enter the name of the macro prefaced by a # symbol. If your Anchor Name is
    topofpage, you'll enter #topofpage when creating your link.

To link to an Anchor macro on another page:

 1. Copy the URL of the page whose anchor you want to link.

 2. Make note of the name of the anchor to which you want to link. The name is
    displayed on the anchor when editing the page.

 3. Go to the page where you want to add the link and edit the page.

 4. Highlight the text to be used as the link.

 5. Select the link tool .

 6. Paste the URL to the copied page in the link field followed by a # symbol
    and the anchor name.
    Example
    page name = Project notes
    
    Anchor name = notes from today
    Link = sitename.domain/wiki/Project+notes#notes-from-today

Pro tip — if you are adding a link to an anchor from a Gliffy diagram, you must
use the entire URL, not just the pagename#anchorname portion.


LINK TO ATTACHMENTS

To link to a page’s attachment:

 1. Go to the published version of the page containing the attachment to which
    you want to link.

 2. Go to More ••• > Attachments.

 3. Right-click on the file name of the attachment, and select Copy Link
    Address.

 4. Go to and edit the page where you want to link to the attachment.

 5. Paste the URL in the link tool pop-up, and give it a more friendly name if
    desired.

To link to the latest version of an attachment on another page:

 1. Go to the published version of the page containing the attachment to which
    you want to link.

 2. Go to More > Attachments.

 3. Right-click on the file name of the attachment, and select Copy Link
    Address.

 4. Go to and edit the page where you want to link to the attachment.

 5. Paste the URL in the link tool pop-up, remove any text after the file
    extension in the URL, and give it a more friendly name if desired.


CREATE AND LINK TO AN UNDEFINED PLACEHOLDER PAGE

Sometimes you want to link to a Confluence page that doesn't exist yet. To do
this, you can add an undefined link and come back to it later. When you select
on the link, Confluence will create a draft page with that title for you to then
add content to and publish when you're ready.

Undefined placeholder links can't be added to templates.

 1. Type [Placeholder Page Name](). 
    This follows the syntax as the keyboard shortcut for adding defined
    links [Link] (http://a.com).

 2. Press Enter or Return to create the placeholder.

 3. Select Close to keep the page as a DRAFT or select Publish… or Update.

Using a keyboard shortcut is the only way to accomplish this right now. In the
coming months, the ability to add undefined links will be added to the editor
toolbar and slash command menu.

A link to an undefined page is shown in red. Until you actually publish this
newly created page, anyone with create permissions in that space can select on
the link, while viewing or editing, and it will continue to create new draft
pages. 

VIEW UNDEFINED PAGES IN A SPACE

The Undefined page shows you all the undefined pages in your space. 

To view a list of the undefined links in a space:

 1. Go to the space in Confluence Cloud.

 2. Select Space settings from the sidebar.

 3. Select Undefined from the Manage pages card.

The undefined page links have a green badge to remind you that these
pages haven't been published yet. Select an undefined page link to create a
draft and add content to it.


DISPLAY OPTIONS

Once you type in or paste a link when editing a Confluence page, you can choose
how it appears after you publish.

To change the Smart Link display:

 1. Type in or paste a link, or use the /link command. You may also use Cmd +
    K for Mac or Ctrl + Z for Windows:

 2. Select the link.

 3. From the Smart Link toolbar, select your preferred display option:




INLINE VIEW

Instead of a URL, inline view shows only the title of the link. This is useful
when you want to insert multiple links in a table.




CARD VIEW

Card view offers more context by showing metadata like project details and
summary. When your readers hover over Smart Links displayed in card view, they
can interact with link elements or preview the content. Select Open preview to
view the link at near page-width without leaving the page.




EMBED VIEW

Embed view allows you to view pages, boards, lists, timelines, or calendars in
other products without having to leave the page. Watch a video from YouTube,
read and edit documents, leave comments in your design files and more, all
within your current page.




SMART LINKS FROM JIRA AND OTHER PRODUCTS

You may insert links from other products and convert them into Smart Links.

For example:

 * Display Jira issues in a list

 * Display your Assets data on a Confluence page

 * Share Jira dashboards in Confluence

Other products that use Smart Links:

Atlassian products:

Non-Atlassian products

 * Atlas

 * Atlassian Analytics

 * Bitbucket

 * Compass

 * Jira

 * Jira Roadmaps

 * Jira Align

 * Trello

 * Adobe XD

 * Asana

 * Azure Devops

 * Box

 * Dropbox

 * Figma

 * GitHub

 * GitLab

 * Gliffy

 * Google Drive

 * Invision

 * Microsoft OneDrive (personal only)

 * Miro

 * Mural

 * Salesforce

 * Slack

 * Stripe

 * YouTube

 * Zeplin

 * Zoom


AUTHENTICATION FOR SMART LINKS

You must be logged in to non-Atlassian products that require authentication
before you can display the Smart Link in your page. You’ll only need to do this
once, and that product’s links will work across all of Atlassian Cloud.

For links to non-Atlassian product that requires access to view, readers need to
be logged in for Smart Links to display in the correct view.

What data is sent and received when pasting a Smart Link?


SUMMARIZE SMART LINKS WITH AI

Save time by summarizing the content of a Smart Link with Atlassian
Intelligence.

To use Atlassian Intelligence in Confluence, your organization admin needs to
activate AI features from Atlassian Administration.

To summarize a Smart Link with AI:

 1. Navigate to the Confluence page or blog post containing a Smart Link.

 2. Hover over any Smart Link.

 3. Select Summarize with AI.

 4. Atlassian Intelligence will generate a summary.

A summary will not generate if there isn’t enough content to summarize or if
summarizing the content might go against Atlassian’s Acceptable Use Policy.

For more on how Atlassian Intelligence works, its limitations, and our
commitment to privacy, visit the Atlassian Trust Center.


SMART LINK PREFERENCES

You can set your preferences on how links are displayed across Confluence,
Atlas, Jira and soon for other Atlassian products. Your chosen link display
option appears when you edit pages or comment on issues.

Go to link preferences from Confluence:

 1. Select your avatar from the top-right menu.

 2. Select Manage Account.

 3. Select the Link preferences tab at the top.

Go to link preferences from Jira:

 1. Select the settings cog [cog image] on the top-right menu.

 2. Under ‘Personal settings, select Atlassian account settings.

 3. From the left-side menu, select Link preferences.


SET YOUR DEFAULT DISPLAY FOR NEW LINKS

You can choose how to display links you create:

 1. From Link preferences, go to the Default display section.

 2. Choose your preferred display option from the dropdown.

Links created by other users will appear depending on the display option they
choose.

Remember to refresh active editor sessions after you update your preferences.


EXCEPTIONS FOR SPECIFIC DOMAINS

You can set different display options for links from specific domains:

 1. From Link preferences, go to the section labeled Exceptions for specific
    domains.

 2. Type or paste in a domain or URL.

 3. Choose your preferred display option from the dropdown.

 4. Select Submit.

 5. Add exceptions for other domains if needed.


EXCEPTIONS FOR SUBDOMAINS

You may enter subdomains as your URL to set default display options for links
from specific sections of a website.

For example, if you set a preference for links from google.com to display as a
card, all subdomains will follow the same rule.  

If you only set an exception for slides.google.com, the other Google domains
display as the default setting or any custom preferences you may have set.

If a domain cannot be displayed as an embed, your link will default to inline.

--------------------------------------------------------------------------------


LEGACY EDITOR

This section provides the details for adding links and anchors to your page
using the legacy editor.


INTERNAL LINKS

Here's how to link to content from within Confluence

LINK TO A PAGE

If it's a page in the same space:

 * From the toolbar, select Link > Search then enter part of the page name.
   Select the page when it appears in the list.

 * From the toolbar, select Link > Recently viewed and select a page from the
   list.

 * Type [ and enter part of the page name, then select the page from the list.

 * Paste the URL of the page onto your page (Confluence will automatically
   create the link).

If it's a page in a different space:

 * From the toolbar, select Link > Search and from the space dropdown, either
   select the space the page lives in, or All Spaces. Then enter part of the
   page name, and select the page when it appears in the list.

 * From the toolbar, select Link > Advanced then enter the space key followed by
   the page name spacekey:mypage.

 * Type [ and enter part of the page name then select the page from the
   list. (You can hover over each suggestion to see which space the page is
   from).

LINK TO A BLOG POST

 * From the toolbar, select Link > Search and enter part of the blog post name,
   then select the post when it appears in the list.

 * Type [ and enter part of the blog post name then select the blog post from
   the list.

LINK TO AN ATTACHMENT

On this page:

 * From the toolbar, select Link > Attachment then upload or select an
   attachment from the list.

 * Type [ and enter part of the attachment file name then select the attachment
   from the list.

On another page:

 * From the toolbar, select Link > Search and enter part of the attachment name,
   then select it when it appears in the list. (You can hover over each
   suggestion to see which space the page is from).

 * Type [ and enter part of the attachment file name then select the attachment
   from the list

LINK TO A WEBSITE

 * From the toolbar, select Link > Web Link then enter the website URL.

 * Type or paste the URL onto the page (Confluence will automatically create the
   link).

LINK TO AN EMAIL ADDRESS

 * From the toolbar, select Link > Web Link then enter the email address.

 * Type or paste the email address onto the page (Confluence will automatically
   create a 'mailto:' link).

LINK TO A HEADING ON A PAGE

Choose Link > Advanced then enter the heading in one of the formats below.
Heading text is case sensitive and must be entered without spaces.

 * For a heading on this page: #MyHeading.

 * For a heading on another page in this space: Page Name#MyHeading.

 * For a heading on another page in another space: spacekey:Page Name#MyHeading.

 Be aware that these links will break if you edit the heading text. Consider
using the Table of Contents macro or an Anchor instead.

LINK TO A COMMENT ON A PAGE

 * Go to the comment, right-click the Date at the bottom of the comment, copy
   the link, and paste it directly into your page.

 * Type [$ then enter the Comment ID (12345 in this example):  [$12345]

LINK TO AN ANCHOR ON A PAGE

Use anchors to enable linking to specific locations on a page. These can be
especially useful for allowing your readers to jump to specific parts of a long
document. Anchors are invisible to the reader when the page is displayed.

LINK TO AN ANCHOR

 * Anchor names, including the space key and page name, are case sensitive.

 * Enter page and anchor names with spaces when you link to them in the same
   Confluence site

 * If you're linking to an anchor on a different page that has special
   characters in its name, where the URL displays a page ID rather than a name,
   you should still enter the page name when linking to it

 1. Select some text or position your cursor where you want to insert the link

 2. From the toolbar, select Link in the toolbar or press Ctrl+K

 3. Select Advanced and enter the anchor name in the Link field, following the
    format below.

Anchor location

Link syntax for anchor

Examples

Same page

#anchorname

#bottom

#importantinformation

Page in same space

page name#anchor name

My page#bottom

My page#important information

Page in different space

spacekey:pagename#anchorname

CONFCLOUD:Mypage#bottom

CONFCLOUD:Mypage#importantinformation

4. Enter or modify the Link Text (this is the text that will appear on the page.
If this field is left blank, the page name or URL will be used as the link text)

5. Select Save

LINK TO AN UNDEFINED PAGE (A PAGE THAT DOES NOT EXIST YET) 

Sometimes you want to link to a Confluence page that doesn't exist yet. To do
this, you can add an undefined link and come back to it later. When you select
on the link, Confluence will create a draft page with that title for you to then
add content to and publish when you're ready.

CREATE AN UNDEFINED PAGE LINK:

 1. From the toolbar, select Insert > Link or press Ctrl+K on your keyboard.

 2. Select Advanced from the left navigation

 3. Enter the name of the page to be created in the Link field.

A link to an undefined page is shown in dark red. Until you actually publish
this newly created page, anyone with create permissions in that space can select
on the link, while viewing or editing, and it will continue to create new draft
pages. 

 

VIEW UNDEFINED PAGES IN A SPACE

The Undefined Pages view shows you all the undefined pages in your space. 

To view a list of the undefined links in a space:

 1. Select Space settings in the sidebar, then choose Content tools

 2. Select Undefined Pages.

The undefined page links have a green badge to remind you that these
pages haven't been published yet. Select on the link for an undefined page to
create a draft and add content to it.

LINK TO A PERSONAL SPACE OR USER PROFILE

 * From the toolbar, select Link > Search then enter the user's name and select
   their personal space overview or their profile from the list.

 * Type [ then enter the user's name and select their personal space overview or
   their profile from the list.

LINK TO A JIRA ISSUE (WHERE CONFLUENCE IS CONNECTED TO JIRA) 

 * Paste the Jira issue URL - Confluence will automatically create a Jira Issue
   macro.

USE A SHORTCUT LINK

If you have configured shortcut links on your Confluence site, then you can link
to an external site using a shortcut link that looks like this:CONF-17025@jira.

To add a shortcut link using the Insert Link dialog:

 1. From the toolbar, select Link > Advanced and enter or paste the shortcut
    link into the Link field (shortcut links are case-insensitive)

 2. Modify or enter link text (this is the text that will appear on the page)

 3. Select Insert

You can also type [ and choose Insert Web Link > Advanced  to enter a shortcut
link.


EXTERNAL LINKS

Here's how to link to Confluence content from other websites and in emails.

LINK TO A HEADING 

Example

http://myconfluence.com/display/spacekey/pagename#pagename-headingtext

LINK TO A COMMENT

Example

http://myconfluence.com/display/spacekey/pagename?focusedCommentId=commentid#comment-commentid

To find out the comment URL and comment ID:

 1. Go to the comment you wish to link to

 2. Select the Date at the bottom of the comment and examine the URL

The number after comment- is the Comment ID

LINK TO AN ANCHOR 

Example

http://myconfluence.com/display/spacekey/pagename#pagename-anchorname 

Some important details to keep in mind:

 * The page name is repeated in the URL, after the # sign. The second occurrence
   of the page name is concatenated into a single word, with all spaces removed.

 * There is a single dash (hyphen) between the concatenated page name and the
   anchor name.

 * The anchor name in the full URL is concatenated into a single word, with all
   spaces removed.

 * The anchor name is case sensitive. You must use the same pattern of upper and
   lower case letters as you used when creating the Anchor.

REMOVE OR MODIFY A LINK

 1. Select the link text or image

 2. Select Unlink from the link properties toolbar to remove the link

 3. Select Edit from the link properties toolbar to modify the link, make your
    changes, and choose Save

Was this helpful?

Yes
No
It wasn't accurate

It wasn't clear

It wasn't relevant
Provide feedback about this article


STILL NEED HELP?

The Atlassian Community is here for you.
Ask the Community
 * Create and edit content
 * Show more
 * Use Atlassian Intelligence to help write or edit content
 * Format your page

 * Smart Links in Confluence

 * What data is sent and received when pasting a Smart Link?
 * Bring all your work into Confluence
 * Show more

On this pageCreate and insert linksLink to headings or sectionsLink to a
Confluence commentLink to an email addressLink to an anchorLink to
attachmentsCreate and link to an undefined placeholder pageDisplay optionsInline
viewCard viewEmbed viewSmart Links from Jira and other productsAuthentication
for Smart LinksSummarize Smart Links with AISmart Link preferencesSet your
default display for new linksExceptions for specific domainsExceptions for
subdomainsLegacy editorInternal linksExternal links
CommunityQuestions, discussions, and articles
 * Notice at Collection
 * Privacy Policy
 * Terms of Use
 * Security
 * 2024 Atlassian

This site uses cookies to improve your browsing experience, perform analytics
and research, and conduct advertising. To change your preferences, click Manage
preferences. Otherwise, clicking Accept all cookies indicates you agree to our
use of cookies on your device. Clicking Reject all cookies means you do not
agree to our use of non-strictly necessary cookies on your device.Atlassian
Cookies and Tracking Notice
Manage preferences Reject all cookies Accept all cookies



MANAGE PREFERENCES

When you visit any website, it may store or retrieve information on your
browser, mostly in the form of cookies. This information might be about you,
your preferences or your device and is mostly used to make the site work as you
expect it to. The information does not usually directly identify you, but it can
give you a more personalized web experience. Because we respect your right to
privacy, you can choose not to allow some types of cookies. Click on the
different category headings to find out more and change our default settings.
However, blocking some types of cookies may impact your experience of the site
and the services we are able to offer.
More information
Accept all

STRICTLY NECESSARY COOKIES

Always Active

These cookies are necessary for the website to function and cannot be switched
off in our systems. They are usually only set in response to actions made by you
which amount to a request for services, such as setting your privacy
preferences, logging in or filling in forms. You can set your browser to block
or alert you about these cookies, but some parts of the site will not then work.
These cookies do not store any personally identifiable information.

TARGETING COOKIES

Targeting Cookies

These cookies may be set through our site by our advertising partners. They may
be used by those companies to build a profile of your interests and show you
relevant adverts on other sites. They are based on uniquely identifying your
browser and internet device. If you do not allow these cookies, you will
experience less targeted advertising.

FUNCTIONAL COOKIES

Functional Cookies

These cookies enable the website to provide enhanced functionality and
personalisation. They may be set by us or by third party providers whose
services we have added to our pages. If you do not allow these cookies then some
or all of these services may not function properly.

PERFORMANCE COOKIES

Performance Cookies

These cookies allow us to count visits and traffic sources so we can measure and
improve the performance of our site. They help us to know which pages are the
most and least popular and see how visitors move around the site. If you do not
allow these cookies we will not know when you have visited our site, and will
not be able to monitor its performance.

Back Button


COOKIE LIST



Search Icon
Filter Icon

Clear
checkbox label label
Apply Cancel
Consent Leg.Interest
checkbox label label
checkbox label label
checkbox label label

Reject all Confirm my choices