Using Autocomplete

Summary of Autocomplete

Using Autocomplete for Links

Type '[', or press Ctrl+Shift+K, to see a list of suggested pages or other locations to link to from your page. You can link to pages, user profiles, images, documents and other file attachments.

To autocomplete a link:

1. Edit the page.
2. Click where you want to insert a link and do one of the following:
   • Type '[' and then the first few characters of the page title, user's name, image name or file name.
   • Type the first few characters of the page title, user's name, image name or file name (or select relevant text) and then press Ctrl+Shift+K.
3. Click the relevant link from the list of suggestions.

If the item you need is not in the list, either:

1. • Choose Search for 'xxx' to continue looking for the page within Confluence, or
   • Choose Insert Web Link to insert a link to an external web page using the Link Browser.

Screenshot: Autocomplete for a Link

Using Autocomplete for Images, Videos, Audio Files and Documents

You can use the autocomplete as a fast way of embedding images, videos, audio files and documents into your page. Type an exclamation mark or press Ctrl+Shift+M to see a list of suggested images, multimedia files and documents to display on your page. You can use autocomplete to embed the following file types:

• Images – any format that Confluence supports. See Image File Formats.
• Videos, audio files and all multimedia formats that Confluence supports. See Embedding Multimedia Content.
• Office documents supported by the Confluence Office Connector: Word, Excel and PowerPoint.
• PDF files.

Autocomplete works most efficiently for files that are already attached to the Confluence page. See Attaching Files to a Page.

To embed an image, video, audio file or document:

1. Edit the page.
2. Click where you want to insert the image, video, audio file or document and do one of the following:
   • Type '!' and then the first few characters of the image, file or document name.
   • Type the first few characters of the name of the image, file or document (or select relevant text) and then press Ctrl+Shift+M.
3. Choose the relevant file from the list of suggestions.

If the item you need is not in the list, either:

1. • Choose Open Image Browser to find images and documents using the Image Browser, or
   • Choose Insert Other Media to embed videos, audio and other multimedia files using the Macro Browser. Insert the 'Multimedia' macro to display your multimedia file.

Screenshot: Autocomplete for an Image or Document

Using Autocomplete for Macros

Type '{' to see a list of suggested macros to add to your page.

Autocomplete provides access to all available macros in your Confluence site, including any user macros that your administrator has added and made visible to all.

You need to know the name of macro. Autocomplete for macros will only match the name of the macro, not the description.

To autocomplete a macro using '{':

1. Edit the page.
2. Click where you want to insert the macro.
3. Type '{' and then the first few characters of the macro name.
4. Choose the relevant macro from the list of suggestions.
5. Configure the macro as described in Working with the Macro Browser.

If the macro you need is not in the list, select Open Macro Browser in the list of suggestions to continue looking for the macro in the Macro Browser.

Screenshot: Autocomplete for a Macro

Using Autocomplete for Mentions

You can use autocomplete to automatically notify another Confluence user that you have mentioned them in a page, blog post or comment. 

Type '@' to see a list of suggested users to mention. When you save the page, an email is automatically sent to the user to notify them that they have been mentioned on that page (if they have permission to view the page or blog post). This works for new and updated pages, blog posts and comments.

You need to know the user's real name – autocomplete for mentions suggests users' full names only, not their usernames.

To autocomplete a mention using '@':

1. Edit the page.
2. Click where you want to insert a mention and type '@' and then the first few characters of the user's real name.
3. Choose the user's name from the list of suggestions.

Screenshot: Autocomplete for mentions

Cancelling Autocomplete

The autocomplete starts automatically when you press the trigger characters. You may want to close the autocomplete menu or escape from autocomplete once it has started.

There are a few different ways to stop the autocomplete once it has started:

• Press the escape key, 'Esc', on your keyboard.
• Click somewhere else in the editor panel.
• Press an arrow key to move out of the autocomplete area.
• For the link autocomplete only: enter a right-hand square bracket, like this: ]

Enabling and Disabling Autocomplete

You can turn off the triggering of autocomplete by the '[' and '!' characters. This will prevent the autocomplete from starting automatically when you press one of the trigger characters. You can also turn it back on again.

Notes:

• This setting does not affect the keyboard shortcuts for autocomplete (Ctrl+Shift+K and Ctrl+Shift+M). Even if the trigger characters are disabled, you can still use the keyboard shortcuts for autocomplete.
• This setting affects only you. Other people using Confluence can enable or disable the setting on their user profiles independently.
• Note that autocomplete is enabled by default.

To enable or disable the autocomplete trigger characters:

1. Go to your name (the 'User' menu) at the top of the page and choose Settings.
2. Choose Editor under 'Your Settings' in the left-hand panel.
3. Click Edit.
4. Either:
   • Disable autocompletion by selecting Disable Autocomplete.
   • Enable autocompletion by clearing Disable Autocomplete.
5. Click Submit.

Screenshot: User Settings for the Editor

Related Topics

Working with Links

Using Images

Working with Macros

Keyboard Shortcuts

User Profile Overview

Take me back to the Confluence User's Guide.