How to Turn Off Autoconvert
Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.
Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles 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
The Confluence Autoconvert feature (added in Confluence 4.1) is based on the Confluence Paste system app and can be customized, partially deactivated or switched off.
Configuring Autoconvert
You need to be a 'Confluence Administrator' to carry out this process.
Starting with Confluence 7.0 system apps are no longer configurable from the GUI, you need to use REST calls to disable them. For more information please see the relevant KB.
In order to disable Autoconvert or a specific module tied to this plugin, please follow the following steps:
- Go to Confluence Admin > Configuration > Plugins > Show System Plugins.
- Find Confluence Paste in the list, and click it.
- Take note of the App key.
- Click Manage Plugin Modules to see the full list of configurable modules for Autoconvert, take note of the module key next to their names.
- The entire plugin can be disabled, or each module can be disabled individually. See the table below for a summary of the effects of doing this.
To disable the entire plugin you need to issue the following REST call:
curl --user "<ADMINUSER>:<PASSWORD>" --location --request PUT '<base_URL>/rest/plugins/1.0/com.atlassian.confluence.plugins.confluence-paste-key' \ --header 'Content-Type: application/vnd.atl.plugins.plugin+json' \ --data-raw '{ "enabled": false }'To disable specific modules the REST call needs to be amended to include the module key, as follows:
curl --user "<ADMINUSER>:<PASSWORD>" --location --request PUT '<base_URL>/rest/plugins/1.0/com.atlassian.confluence.plugins.confluence-paste-key/modules/{module.key}-key' \ --header 'Content-Type: application/vnd.atl.plugins.plugin.module+json' \ --data-raw '{ "enabled": false }'
List of important modules with module key and description:
| Plugin Module | Module Key | Functionality it provides | Effect of disabling it |
|---|---|---|---|
| Clipboard Access | paste-resources | Automatic handling of images pasted into the page. | Pasted images will no longer be handled automatically. |
Autoconvert Core | autoconvert-core | The core functionality of Autoconvert. | Disables all Autoconvert features. |
| Autoconvert Confluence | autoconvert-confluence | Automatic handling of URLs pasted into the page. (Transforms URLs from the same Confluence instance into internal links.) | Confluence URLs will no longer be handled automatically. |
| Autoconvert youtu.be | autoconvert-youtu.be-rewrite | Automatic handling of short YouTube URLs pasted into the page. (Rewrites short-form youtube URLs into long-form ones, allowing the Widget Connector to process the video — see below.) | Short YouTube URLs will no longer be handled automatically. |
| Autoconvert Widget Connector | autoconvert-widget-connector | Automatic handling of multimedia URLs pasted into the page. (Transforms a variety of URLs into Widget Connector macros.) | These URLs will no longer be handled automatically. |
| Autoconvert Confluence Shortcut Links | autoconvert-shortcut-links | Automatic handling of Confluence Shortcut URLs pasted into the page. (Reverse engineers appropriate link text for URLs that match configured shortcut links.) | These URLs will no longer be handled automatically. |
| Autoconvert Google Redirects | autoconvert-google-redirect | Automatic handling of Google redirect URLs (copied out of google Search pages) which are pasted into the page.(Transforms Google redirect URLs into the destination URL.) | These URLs will no longer be handled automatically. |
| Autoconvert Rest Endpoint | restEndPoint | Provides REST services necessary for the function of the Shortcut Links and Skitch URL conversion. | Shortcut Links and Skitch URLs will no longer be handled automatically. May also cause Javascript errors in the browser. |
| Rest Servlet Filter | restEndPoint-filter | Automatically created whenever you use a rest endpoint. Should be disabled whenever the Autoconvert REST Endpoint is disabled. | Should be disabled whenever the Autoconvert REST Endpoint is disabled. |