SharePoint Connector Limitations and Known Issues

Use this page to troubleshoot any problems you may have with the SharePoint Connector for Confluence. For instructions on installation, configuration and usage, please consult the documentation for the SharePoint Connector for Confluence.

On this page:


  • Confluence 3.0.2 or later.
  • SharePoint MOSS or WSS: Certain features of the SharePoint Connector require Microsoft Office SharePoint Server (MOSS). If your installation has only Windows SharePoint Services (WSS) and not MOSS, you will not be able to use the advanced features:
    1. For the Federated Search feature. For more information, see Configuring the SharePoint Federated Search on SP 2007.
    2. For Single Sign-On (SSO) functionality from SharePoint using Windows Integrated Authentication to Confluence via Forms Based Authentication. For more information, see the Microsoft product information.
  • Configuration in Confluence: Your Confluence administrator can enable or disable the SharePoint Connector or parts of it in Confluence. Please refer to Installing and Configuring the Confluence Plugins for SP 2007 in the SharePoint Connector Installation Guide and discuss any configuration problems with your administrator.
  • Configuration in SharePoint: Your SharePoint administrator needs to configure the SharePoint feature, web part and federated search components. Please refer to Installing and Configuring the SharePoint Feature on SP 2007 in the SharePoint Connector Installation Guide and discuss any configuration problems with your administrator.

Full list of requirements: For more information on each of the above points, please refer to the complete list of requirements in the SharePoint Connector Installation Guide.

Diagnostic Tools

  • Tracing: To troubleshoot or debug the SharePoint feature you can enable tracing and then view the trace with a tool such as DebugView. See Tracing the SharePoint Feature.
  • Logging: In addition to enabling the tracing feature, critical errors and warning messages are always output to the SharePoint Log. You can view this information by Analyzing the SharePoint Logs.
  • Checking the Confluence configuration: When the SharePoint Connector configuration is set up properly it just works. However when it does not work it can be tricky to diagnose the problem, given the two different platforms trying to authenticate, authorise, and communicate across different servers. Here are some things to check on the Confluence side: Troubleshooting the SharePoint Configuration in Confluence.


  • Integrated Windows Authentication (IWA): IWA, including LM, NTLM, NTLMv2 and Kerberos, requires complex configuration and may cause problems. See the documentation on Planning your Authentication Configuration. This documentation and configuration process is under review. We are working on a simplified procedure as well as simplified documentation.
  • SharePoint Forms-based Authentication: The SharePoint Connector is not able to connect to SharePoint sites that use the Forms authentication module.
  • Crowd: The SP connector does not support Atlassian Crowdfor SSO, when using a Crowd internal directory.
    • Crowd internal directory requires Microsoft SSO: If your Confluence instance uses a Crowd internal directory for user management, you must use the Microsoft SSO service. This means that you must have SharePoint MOSS, because SharePoint WSS does not provide Microsoft SSO.
    • Crowd LDAP does not require Microsoft SSO: If your Confluence users come from Active Directory via Crowd, there is no need for Microsoft SSO because the Confluence user credentials and the SharePoint user credentials are the same.
  • Clicking a link in the Confluence Page web part opens the Confluence page in a new browser window: It would be nice if you could click a link and have the new page open within the web part itself. We are tracking this popular feature request as CSI-196.
  • Some Confluence macros do not work in the Confluence Page web part: Any Confluence macro that performs an Ajax web call will not work in the Confluence Page web part. These are macros that perform a second call do load the macro display data independently of the page. Examples as the Recently Updated macro and the JIRA Issues macro (CSI-423). The problem is caused by security restrictions, because the Ajax call comes from the SharePoint page rather than Confluence.
  • Including private pages from a public page will result in an error message: It is possible in a Confluence wiki page to include the content of another page using the {include} macro. If a page that is generally available (Page A) includes the content of a page that is not generally available (Page B), this works as expected within Confluence as well as within the 'Confluence Page' web part in SharePoint. When a user authorised to see Page B views Page A, they see the content of Page A and the content of Page B. If the user is not authorised to see Page B, they see the content of Page A and an error similar to this: "Unable to render {include} Couldn't find a page to include called: Page B".
  • When using sharePoint list macro in Confluence to render a custom SharePoint view of a SharePoint document library: if the custom view of document library in SharePoint does not include the column with name "Name (linked to document with edit menu)" the layout of list macro in Confluence is broken. It's required that all custom views of document library in SharePoint have to include the column "Name (linked to document with edit menu)" in its view.

Known Issues from our Knowledge Base

The following knowledge base articles can help with troubleshooting:

Resolved Knowledge Base Issues

This section stores all previously reported Knowledge Base articles for the SharePoint Connector for Confluence that have been resolved by making improvements to the core product. If you are affected by any of the following  issues, you should consider upgrading your version of the SharePoint Connector in order to resolve the issue.

List of Unresolved Issues from our Issue Tracker

Below is a list of the open issues for the SharePoint Connector.

  • Before reporting a bug or requesting a new feature, please take a look to see if it has already been reported.
  • If you find a likely-looking issue, click the link to find more information and possible workarounds.

From the Atlassian issue tracker for the SharePoint Connector:

T Key Summary Reporter Status
Bug CSI-703 Umbrella issue for problems with certain macros rendering incorrectly in the Confluence Page web part Joe Clark [Atlassian] Open
New Feature CSI-714 Investigate integrating the office connector viewfile macro with the SharePoint Connector Joe Clark [Atlassian] Open
Bug CSI-949 When using the Microsoft SSO or Secure Store Service, there is no way to map Confluence usernames back to SharePoint usernames Joe Clark [Atlassian] Open
New Feature CSI-26 Research how to show SharePoint workflow actions in our interface Brendan Patterson [Atlassian] Open
New Feature CSI-59 enhance the Confluence Excel macro to display from a SharePoint hosted Excel document Brendan Patterson [Atlassian] Open
New Feature CSI-93 Digitally sign installer Kirk Liemohn [Atlassian] Open
Improvement CSI-197 redirect link from user profile to sharepoint My Site Brendan Patterson [Atlassian] Open
New Feature CSI-200 Display list of recently edited wiki pages on a user's my site in sharepoint Kirk Liemohn [Atlassian] Open
New Feature CSI-216 Option to provision a Confluence Space when a SharePoint site is provisioned Chaney Edwards Open
Bug CSI-232 Gallery macro does not work within Confluence Page web part Kirk Liemohn [Atlassian] Open
Bug CSI-382 pagetreesearch macro does not work within Confluence Page web part Kirk Liemohn [Atlassian] Open
New Feature CSI-397 Allow displaying non-list SharePoint content within the plugin Kirk Liemohn [Atlassian] Open
Bug CSI-421 Pagetree macros will not work when used in a Web Part Mark Hrynczak [Atlassian] Open
New Feature CSI-432 Allow sharepoint wiki content to be embedded in Confluence Ryan Ackley [Atlassian] Open
Bug CSI-450 chart macro is broken Jonathan Gilbert Open
Bug CSI-451 RSS macro does not render in Confluence Page Web Part Jonathan Gilbert Open
New Feature CSI-457 Federated Search Confluence -> Sharepoint Jonathan Gilbert Open
Bug CSI-484 Sharepoint Connector Confluence Page Web Part does not render the {pagetree} or {pagetreesearch} macro Vincent Chang Open
Improvement CSI-486 Create FLD file for Federated Search Jonathan Gilbert Open
New Feature CSI-489 Partial pages in Web Part Jonathan Gilbert Open
Showing 20 out of 126 issues Refresh

Requesting Support

If you have a problem, please take a look at the prerequisites, diagnostic tools, limitations and known issues described above.

If you do not find a solution to your problem, please help us to troubleshoot the issue by providing the following information before submitting a support request on the Atlassian Support System:

  1. Find the base URL of your Confluence server. To see your base URL, open Confluence in your web browser, log in as a Confluence administrator and visit http://<Your Confluence URL>/admin/viewgeneralconfig.action.
  2. Tell us which browser you are using when the problem occurs, and which version of the browser such as Firefox 3.6.2 or Internet Explorer 8.0.
  3. Tell us which operating system you are using when the problem occurs, such as Windows Vista, Windows XP, Linux, Mac OS X.
  4. Capture a Fiddler report for tracking read-only issues.
  5. Run Confluence's generic error page by visiting http://<Your Confluence URL>/500page.jsp and give us the result for review. Please copy the whole page including the list of enabled plugins.
  6. Include your Confluence logs and a copy of the information on your Confluence 'System Information' page. To get this information, go to 'Confluence Admin', 'System Information' and copy the text from the page. We need that information to see what Confluence version and which application server you are using.
  7. Let us know what you are using for Confluence user management: Confluence internal user management, LDAP (Active Directory), Crowd internal directories, Crowd LDAP, JIRA user management, or any other user management scenario.
  8. Tell us whether you have MOSS or WSS installed.
    To determine whether you have WSS 3.0 or MOSS 2007 installed, go to Windows Start -> Control Panel -> Add/Remove Programs.
    • If you see 'Microsoft Office SharePoint Server 2007' in the list, then MOSS 2007 has been installed.
    • If you see only 'Microsoft Windows SharePoint Services' in the list (and not 'Microsoft Office SharePoint Server 2007') then you only have WSS 3.0 installed.
  9. Ask your SharePoint administrator which SharePoint service packs you have installed.
  10. Find out which version of the SharePoint Connector you have installed in SharePoint. To find this out, go to the 'Confluence Administrative Settings' page in SharePoint.
    • Go to the top level site within the site collection.
    • Select 'Site Actions' (at the top-right) -> 'Site Settings' -> 'Modify All Site Settings'.
    • On the 'Site Settings' page, choose 'Confluence Settings'.
    • On the 'Confluence Administrative Settings' page, copy the value for the 'Connector Version' (in the section labelled 'Confluence Site').

SharePoint Connector User's Guide
SharePoint Connector Administrator's Guide
SharePoint Connector Installation and Upgrade Guide

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport