You're visiting the Confluence Knowledge Base. Visit the Confluence Knowledge Base Home for an overview.

Skip to end of metadata
Go to start of metadata

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

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 Analysing 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 Confluence SharePoint Connector 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:

JIRA Issues Macro: Data cannot be retrieved due to an unexpected error

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

Page: SharePoint Connector Resolved Known Issues Page: Sharepoint Federated Search Webpart Is Blank when Searching Page: Sharepoint Connector Incompatible with JDK 1.4 Page: Sharepoint Webpart Shows 'Unable to load spaces or pages from Confluence' Page: Extra Slash Character in Confluence Images URL Page: Test Confluence Configuration Failed in Sharepoint Page: Cannot Add the Specified Assembly to the Global Assembly Cache Page: SharePoint Formats the Confluence Search Results Badly Page: SecurityException upon Running SharePoint Web Parts Installer Page: Test Connection from Sharepoint Administration Page Failed in Confluence Page: 'A call into SPS Single Sign-on failed' Due to Invalid Credentials in the Database Page: Images Are Broken in the Confluence Page Web Part in SharePoint Page: Federated Search Results Render Very Slowly Page: More results' Link Contains $$impersonate=UserName$$ in Federated Search Results Webpart Page: Confluence Federated Search Results Appear in a Narrow Column in SharePoint 2010 Page: Unable to delete Confluence configuration from SharePoint Site Page: Connection Test to SharePoint fails with 'Problem connection to SharePoint (null). Check the atlassian-confluence.log for exception details' Page: SharePoint List macro {sp-list} Failed with "Error rendering macro {sp-list}: Unable to retrieve list" Page: Unable to load Confluence configuration in SharePoint - Unable to decrypt persisted value Page: SharePoint Unable to Connect to SSL-secured Confluence Page: SharePoint Basic Connection Test Failed - Connection refused: connect Page: Clicking SharePoint Connector Administration Page Leads to Stacktrace Page: Auto-complete for SharePoint List Macro Smart Fields Not Working in Confluence Macro Browser Page: After upgrading the SharePoint Plugin in Confluence, it is no longer possible to connect from SharePoint to Confluence Page: SharePoint Connector Plugin's SOAP proxy is not working Page: Unable to successfully install SharePoint Connector in SharePoint server with "SharePoint was unable to connect to the database sever" Page: Unable to access Sharepoint admin in Confluence Page: Inserting Sharepoint Document Link: An error prevented the search from completing. Page: SharePoint Server 2013 Federated Search Result doesn't Include Confluence Data Page: SharePoint Search Box in Confluence 5.7 Displays White Text on White Background