Linchpin User Profiles - Documentation

Create a meaningful and up to date profile

See the documentation for your Release

Installation & Licensing

The Custom User Profile plugin is a type two add-on, please follow the installation instructions as given by Atlassian: Installation steps via Universal Plugin Manager

  1. Log into your Confluence instance as an administrator.
  2. Click the admin dropdown and choose Atlassian MarketplaceThe Find new add-ons screen loads.
  3. Locate Custom User Profile via search. The appropriate add-on version appears in the search results.
  4. Click Try free to begin a new trial or Buy now to purchase a license for Custom User ProfileYou'll be prompted to log into MyAtlassian if you're logged out. Custom User Profile begins to download.
  5. Enter your information and click Generate license when redirected to MyAtlassian.
  6. Click Apply licenseIf you're using an older version of UPM, you can copy and paste the license into your Confluence instance.


Release 1.13(error)(error)(error)(tick)(tick)(tick)(tick)(error)
Release 1.12(error)(error)(tick)(tick)(tick)(tick)(tick)(error)
Release 1.11(error)(error)(tick)(tick)(tick)(tick)(tick)(error)
Release 1.8 - 1.10(error)(error)(tick)(tick)(tick)(tick)(error)(error)
Release 1.4 - 1.7(error)(error)(tick)(tick)(tick)(error)(error)(error)
Release 1.3(error)(tick)(tick)(tick)(error)(error)(error)(error)
Release 1.2(error)(tick)(error)(error)(error)(error)(error)(error)
Release 1.1(tick)(error)(error)(error)(error)(error)(error)(error)


New in 1.13: Cascade Selection

Add cascading select fields: See Cascade Selection.

New in 1.13: Data sources


You can add an alternative LDAP and an XML-import (p.e. from a SAP Export) to fill your users' profiles automatically.

New in 1.13: Restricted categories


You can now restrict profile field categories to prevent users from seeing fields they don't need. 

By choosing group restrictions, all profile fields within this category are only viewable / editable for users within the configured groups. 
Users from other groups will not see these field in their profile. By default no groups are configured, so every user has the profile fields from this category.

(warning) This is not a security restriction, it is meant to reduce overhead for users! If a user has set a field, which is restricted later, the value can still be found in the search.

Theo Schröder ist in the "confluence-administrators" group, so he can see and edit all fields inside the "Admin only knowledge" category.

Kathrin Holmes is not in this group, therefore she can't see this field in her profile.


New in 1.13: New Field type "Dependent Field"

This field type is a tool to define a conversion from any profile field (e.g. an alphanumeric code) to an output (e.g. a human readable description) for your users’ profile pages, depending on the returned value. You can define any number of dependencies. Users cannot edit these fields. As soon as a user edits a referenced field all dependent fields will be updated immediately. For non editable profile fields like the user locale or the confluence groups there is a new scheduled job which updates all dependent fields for all users.

A dependent field cannot depend on a cascade select or another dependent field.


Custom landing spaces


Set up custom landing pages for users based on their user profiles. After logging in, users are redirected to a customized space, e.g., the team space for a certain location and department. 



Org Charts


You can now define which field of the type "User select (autocomplete)" holds the superior/subordinate connection of one user to another.





Scheduled profile update job


To update the LDAP data in the user profiles regularily a scheduled Confluence job ("Bulk profile update (LDAP sync)") will try to connect to the configured LDAP and update the user profiles.

Known Issues

"Profile Updated" by Anonymous due to Confluence Synchronization

When Confluence synchronizes against any external user management, all of the newly created and updated users will be displayed under the "All Updates" section of "Recently Updated" macro in Confluence dashboard.

Considering the amount of users Confluence will create or update from the synchronization, it would be better to be excluded from "All Updates" section. Or at least, Confluence should provide the option to exclude these updates.

From Confluence 5.5 and later you can add the following argument in your JVM options to prevent updates to user information appearing in the dashboard


Parentheses in filters are treated wrong

Since we have introduced complex filters for your custom landing pages, parentheses in filters are treated as logical characters. So your filter might be broken if you try to filter by attributes containing parentheses.
A workaround would be using the wildcard '?' instead of a parenthesis.

Problems with uploading profile pictures using Internet Explorer

Im some server configurations, a problem can occur when uploading profile pictures using the Internet Explorer. This problem leads to a page with the text "Loading...", and the user is unable to resize the picture. If this happens, the following snippet can be added to the Apache configuration, which should solve the issue (example for .png-files):

<LocationMatch ".*\.png$">
ForceType image/png
Header set Content-Disposition inline
Header set Content-Type image/png;charset=UTF-8




  • No labels

This content was last updated on 05/17/2016.

This content hasn't been updated in a while. That doesn't have to be a problem. Some of our pages live for years without becoming obsolete. Please click this link if you want us to update this page. Old content can be incorrect, misleading or outdated. Please get in contact with us via a form on this page, our live chat or via email with if you are in doubt, have a question, suggestion, or want changes from us.