Linking for Confluence Feature Differences

Server/DC

Cloud

Migration Path is available

Needed

• Understand the feature differences (see below) between the application for the Confluence server and the Confluence cloud.

• Allocate time for a test migration to understand the steps required to migrate data and complete re-configuration.

• This guide assumes you have successfully migrated your  Confluence Server data into Confluence Cloud, per  Atlassian's instructions (CCMA). More Atlassian resources are available here.

Versioning/License

Version Support

Minimum migratable Version : 5.4.3

Migrate to Redirection for Confluence using the steps at Migration Path

License

Available through Atlassian Marketplace.

Available through Atlassian Marketplace only. Monthly subscriptions are the default option; however, discounted annual subscriptions are available upon request from our Atlassian Sales team.

Integration with other macros

Linking macros allows

• Integration with other macros.

• Support of nested macros, which means Linking macros can easily be nested and integrated with other Confluence native macros or any third-party macros

• Integration with Scaffolding macro

Linking macros in the Cloud have the following limitations:

• It does not support nested macros, which means Linking for Confluence Server & Data Center macros cannot be placed in a nested container (such as inside an expand macro, etc.)

• Due to the above, other macro integration is difficult.

• Currently, the Linking macro cannot be used with the Scaffolding macro.

Macro Differences Overview

Server Macros 

Cloud Macros 

Macros availability

• Only some macros are available in the Cloud
  
  
  

• Look out for icons highlighting how the data will be migrated.
  
  

  •  – Available 

  •  – Unavailable

  •  – Partially available
    
    
    

• Migration for the following Linking macro works out of the box

  • Add Page 

  • Add Page via Form 

  • Incoming Links 

  • Outgoing Links 

• For macros that are migrated but are unsupported, the following applies:

  • You may see an "unknown macro" where the macros were initially positioned in the documents

• Find details of each migratable macro below and the differences in terms of behavior once migrated to the Cloud

• Add Page 

• Add Page via Form 

• Child Counter Status 

• Incoming Links 

• Link in New Window 

• Link Page 

• Link to Location 

• Orphaned Links 

• Outgoing Links 

• Undefined Links 

• Add Page

• Add Page via Form

• Incoming Links

• Outgoing Links

Server

Cloud

Add Page 

Supported macro parameters

• Name

• Link Text

• Source

• Source Type

• Live Template 

• Prefix

• Postfix

• Parent

• Labels

• Tip 

• Allow Rename 

Supported macro parameters

• Name

• Link Text

• Source

• Source Type

• Live Template

• Prefix

• Postfix

• Parent

• Labels

 Notes about Cloud migration

• While functionality is the same, Prefix and Postfix parameters accept different values in the server and Cloud.

• You may need to re-write the values for these parameters after migrating to Cloud. Check here for more information about what values the Cloud accepts.

Add Page via Form

Supported macro parameters

• Link Text

• Button Text

• Source

• Source Type

• Live Template  

• Prefix

• Postfix

• Parent

• Labels

• Tip 

• Allow Rename 

• Name Field Width 

Supported macro parameters

• Link Text

• Button Text

• Field hint

• Source

• Source Type

• Live Template

• Prefix

• Postfix

• Parent

• Labels

 Notes about Cloud migration

• While functionality is the same, Prefix and Postfix parameters accept different values in the server and Cloud.

• You may need to re-write the values for these parameters after migrating to Cloud. Check here for more information about what values the Cloud accepts.

Incoming Links

Supported macro parameters 

• Page  

• Spaces 

• Display Mode  

• Separator   

• Bullet Style 

• Maximum Results 

• Display Excerpt 

• Content Types 

• Scope 

• Labels 

Supported macro parameters

• Spaces

• Bullet Style

• Display Excerpts

Outgoing Links