In this article, we take you through the steps of creating new OSLC links or adding links to existing OSLC resources from your Confluence page using OSLC Connect for Confluence.

It assumes that your setup has been previously handled by the various Administrators at their respective levels.

You can suggest your Administrators review the corresponding Learning Journeys if you happen to have any problem with that:

To create or add a new link:

  1. Go to the Edit mode of your Confluence page.

  2. Type {oslc onto the page and select the OSLC Connect - Link macro.

    Alternatively, you can use the macro browser:

If you don’t see the macro listed, reach out to your Administrator to review the Learning Journeys listed above that cover the installation of the plugin.

Use the OSLC Link Dialog

When you click on the macro name, the macro will open the form to Select or Create an OSLC artifact.

The next step is to select the Domain and a Container. To do so:

  1. Select the domain among those for which you have created a Space Association.

  2. Choose your target container.

If this screen is mentioning Global Configurations, then your artifact container is Global Configuration enabled and you may review Global Configurations for Confluence Links.

Linking to an existing resource

  1. Select the Link to existing radio button.

  2. Choose the artifact type.

  3. Click Add Link.

You can then select one or more artifacts from the remote repository using its Selection Dialog.

Creating a resource and linking to it

  1. Select the Create new radio button.

  2. Choose the artifact type.

  3. Click Add Link.

You can then fill out the form from the remote application to create an artifact there.

When you submit the Creation Dialog, the artifact is automatically created in the remote container (IBM ELM, Polarion ALM) and linked to the active artifact in our local repository (Confluence).

The default Link Display

Links’ default rendering will be a standard link, such as:

You can now save your page and your links will be rendered as follows:

Other Link Display Styles

When in Edit mode, upon left-clicking the link, you can:

  • choose the Link display style,

  • preview what your Link will look like once saved,

  • or remove the Link.

When choosing a specific display style, you can preview how your link will be displayed once the page is saved. Link displays are available in the following styles:

  • Link Preview:


  • Small Preview:


  • Large Preview: