# Export Project Documentation to Confluence - Cloud

## Opening Glass Documentation <a href="#exportprojectdocumentationtoconfluence-cloud-openingglassdocumentation" id="exportprojectdocumentationtoconfluence-cloud-openingglassdocumentation"></a>

Users with [Glass View permission](http://codecanvas.atlassian.net/wiki/spaces/GLASS/pages/558628888/2+-+Configuration) can access Project Configuration Documentation from the **project sidebar** menu, by clicking on the **Glass Documentation** menu:<br>

![Open Glass Documentation](https://984802035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiS3B6kMKXfLjLipHhiaL%2Fuploads%2Fntb76FRCp9bLTRp5PahW%2Fimage.png?alt=media\&token=1a345e89-4b98-4d6c-ab03-07ca648b7f23)

## Export as Confluence Page <a href="#exportprojectdocumentationtoconfluence-cloud-exportasconfluencepage" id="exportprojectdocumentationtoconfluence-cloud-exportasconfluencepage"></a>

### Authenticate to Confluence <a href="#exportprojectdocumentationtoconfluence-cloud-authenticatetoconfluence" id="exportprojectdocumentationtoconfluence-cloud-authenticatetoconfluence"></a>

{% hint style="warning" %}
To be able to successfully export to Confluence, a Confluence instance must be connected through a valid **OAuth** authentication, per user.
{% endhint %}

Before the first export, every user needs to authenticate to Confuence securely via OAuth.<br>

![Authorization warning](https://984802035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiS3B6kMKXfLjLipHhiaL%2Fuploads%2F2sEQ02gfy3NJGpbNQj2n%2Fimage.png?alt=media\&token=af970353-efce-45d2-8847-f4bee0e70bc7)

Select the target Confluence instance - and when your authentication is set, you can continue with exporting.<br>

![Authorization screen](https://984802035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiS3B6kMKXfLjLipHhiaL%2Fuploads%2FTSMg89GfEacmT7IaqxEz%2Fimage.png?alt=media\&token=fd8a738c-a916-4964-bf94-c36911734f33)

If you want to Authorize an other Confluence, you can always do that.<br>

![Authorize new Confluence button](https://984802035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiS3B6kMKXfLjLipHhiaL%2Fuploads%2FVxuV9TPBsACK59BcFleh%2Fimage.png?alt=media\&token=b595797d-db5f-4b00-8e10-3beb78eabd4b)

{% hint style="info" %}
**From 1st November 2021** - Atlassian implemented a security patch, which affects Confluence authentication.

**Effect**: The user needs to authenticate again to Confluence if he or she did not export in the last 30 days. Otherwise the export should work undisturbed.
{% endhint %}

### Export Content <a href="#exportprojectdocumentationtoconfluence-cloud-exportcontent" id="exportprojectdocumentationtoconfluence-cloud-exportcontent"></a>

Click on **Export as** on the top right corner, select **Confluence** from the dropdown menu:

![Export button](https://984802035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiS3B6kMKXfLjLipHhiaL%2Fuploads%2FbovMQbvaVvnQAcKTnTQN%2Fimage.png?alt=media\&token=cf2d89e0-be80-468a-bca3-2af8336de020)

Before exporting, you can select which content would you include into the export. This can be useful when you want to export every issue type as a page, or just don't need every detail at the moment.

<figure><img src="https://984802035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiS3B6kMKXfLjLipHhiaL%2Fuploads%2FZi4cWocFdBMqe4SuN7v8%2Fimage.png?alt=media&#x26;token=df0452df-12f3-4a42-89e3-b4f77647bb46" alt=""><figcaption><p>Select what you need in the export</p></figcaption></figure>

There are two different ways to export:&#x20;

* **CREATE** - new documentation as a child page
* **UPDATE** - existing documentation

User can choose

* The **Confluence Instance** which has a valid OAuth connection to your Jira
* The **Confluence Space** within the instance, where the export will take place
* The **Confluence Page**
  * to which the child page will be created
  * which will be updated
* The **Page Title** - the name of the created / updated page

{% hint style="info" %}
To list available Spaces and Pages click in the field and **start typing**.
{% endhint %}

![Confluence export screen](https://984802035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiS3B6kMKXfLjLipHhiaL%2Fuploads%2Fp8xuw5dHigUHJ3BRgRTx%2Fimage.png?alt=media\&token=e561337e-2999-48c7-b8ad-b94ebf20dedc)

{% hint style="info" %}
Note that **CREATE** operation creates a page **as a child page**, under the selected **Confluence Page**, while **UPDATE** operation actually **updates the** selected **Confluence page** with new Title and Content.
{% endhint %}

The exported page contains most of the information available with Glass Documentation - in Jira ([see limitation here)](https://docs.meta-inf.hu/glass-documentation/general-product-information/cloud-vs-on-premise)<br>

![Exported to a confluence page](https://984802035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiS3B6kMKXfLjLipHhiaL%2Fuploads%2F6No8uq8wyXEIXuqPMyyS%2Fimage.png?alt=media\&token=901ee175-cbf7-4333-a6a2-6b33bac3864b)

## Page Properties Report <a href="#exportprojectdocumentationtoconfluence-cloud-usingpagepropertiesreport" id="exportprojectdocumentationtoconfluence-cloud-usingpagepropertiesreport"></a>

{% hint style="success" %}
**Pro Tip** - Use Confluence’s *Page Properties Report* to quickly overview all exported Documents!
{% endhint %}

All exported pages come with a label: *glass-jira-project-documentation* and a hidden page property macro with the most important data of your project.

After you have exported some pages with Glass, create a new page in your Confluence and insert **Page Properties Report** macro, with the following settings. (Only the label is necessary for this report, so you can create cross-space overview as well).<br>

![Page properties macro](https://984802035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiS3B6kMKXfLjLipHhiaL%2Fuploads%2F5iIdlY1ZVb5gUQuDUEgI%2Fimage.png?alt=media\&token=ce0bcaff-b3a8-4828-8177-7e4089db3772)

When the macro is inserted, this page becomes an automatically updated page with all your project configurations. You can easily overview project complexity by comparing workflows, issue types, and People in the project.<br>

![Overviewing all exported pages](https://984802035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiS3B6kMKXfLjLipHhiaL%2Fuploads%2FhRPqlA8O4uOmhFWurWP3%2Fimage.png?alt=media\&token=c63b19fa-eb19-43a7-995c-cb040aeb7729)
