How to Turn Off Autoconvert

Still need help?

The Atlassian Community is here for you.

Ask the community

This article requires fixes

This article has been Flagged for fixing. Use caution when using it and fix it if you have Publisher rights.

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:

  1. Go to Confluence Admin > Configuration > Plugins > Show System Plugins
  2. Find Confluence Paste in the list, and click it.
  3. Take note of the App key.
  4. Click Manage Plugin Modules to see the full list of configurable modules for Autoconvert, take note of the module key next to their names. 
  5. 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.
  6. 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
    }'
  7. 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 ModuleModule KeyFunctionality it providesEffect of disabling it
Clipboard Accesspaste-resourcesAutomatic handling of images pasted into the page.Pasted images will no longer be handled automatically.

Autoconvert Core

autoconvert-coreThe core functionality of Autoconvert.Disables all Autoconvert features.
Autoconvert Confluenceautoconvert-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.beautoconvert-youtu.be-rewriteAutomatic 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 Connectorautoconvert-widget-connectorAutomatic 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 Linksautoconvert-shortcut-linksAutomatic 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 Redirectsautoconvert-google-redirectAutomatic 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 EndpointrestEndPointProvides 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 FilterrestEndPoint-filterAutomatically 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.
Last modified on May 24, 2022

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.