# Integration with Refined Sites

📝

This guide details the integration of the **Capable Publishing feature** with **Refined Sites for Confluence**, allowing users to transform draft content into published articles via automated workflows and structured approvals.

Welcome to the guide on how to integrate **Capable’s Publishing Tool** with **Refined Sites for Confluence**. This setup allows you to transform draft content into polished, published articles with automated workflows, structured approvals, and external visibility — all without leaving your Confluence workspace.

---

## [#](#what-is-refined-for-confluence)What is Refined for Confluence?

[Refined Sites for Confluence](https://marketplace.atlassian.com/apps/1221322/refined-sites-for-confluence-intranets-documentation-kbs?hosting=cloud&tab=overview) is a powerful tool that turns your Confluence content into beautifully styled websites for documentation, knowledge bases, wikis, and intranets.

With **Capable + Refined**, you can:

* Draft, review, and publish content without copy-pasting.
* Automate approvals and publishing steps.
* Keep internal and external content clearly structured and compliant.

---

## [#](#draft-to-live-workflow-overview)Draft-to-Live Workflow Overview

1. **Create in Draft Spaces**  
Draft new content in dedicated draft spaces such as “Brushes Draft” or “Marketing Draft.”
2. **Use Capable for Approvals**  
Assign approvers, review content, and maintain accountability with approval logs.
3. **Publish via Capable**  
Once approved, pages are published to the public-facing “Publish Space” — which Refined renders into your live website.
4. **Sync with Refined Site**  
Published pages automatically appear in your Refined site under the appropriate section.

![Refined - Capable Integration](https://help.gocapable.com/images/785a9c00-d477-42f9-a597-7a9abc349e7e.webp)

---

## [#](#setting-up-refined-sites)Setting Up Refined Sites

1. **Install the Refined App** from the Atlassian Marketplace.
2. Go to the **Refined Dashboard** and create a new site.
3. Customize your site using templates.
4. Link Confluence spaces (like “Brushes,” “Pens,” etc.) to Refined site sections.

---

## [#](#writing-publishing-content)Writing & Publishing Content

* Create articles in your draft space.
* Use tools like ChatGPT for faster content generation.
* Review content in context within Confluence.
* Use Capable’s Publishing button (not Confluence’s native publish) to push content live.

---

## [#](#managing-multiple-draft-spaces)Managing Multiple Draft Spaces

You can route content from multiple draft spaces (e.g., Technical Writers, Marketing Teams) into a single publish space:

* Go to **Space Settings → Capable → Publishing**
* Enable publishing and set the shared **target space** (e.g., “Brushes”).

This allows different teams to contribute without stepping on each other’s toes.

![Confluence Publishing Space Settings](https://help.gocapable.com/images/0b0b826e-7cdf-4995-b781-d54368fa060c.webp)

---

## [#](#using-capable-approvals)Using Capable Approvals

Capable’s Approvals module allows for:

* **Manual and automated approvals**
* Notifications via **Slack** and **Email**
* Assigning multiple approvers
* Setting **minimum approvals or rejections**
* **Approval expiration dates** for recurring review cycles

Once approved, pages can be **automatically published**.

![Confluence Publishing Space Settings](https://help.gocapable.com/images/a9418687-fa2d-49e1-91cc-9a02a493eeb6.webp)

---

## [#](#automation-tips)Automation Tips

* **Auto-send approval requests** when a new page is created.
* **Auto-publish** a page as soon as it’s approved.
* Combine these for a seamless draft-to-live flow.

---

## [#](#managing-outdated-content)Managing Outdated Content

Capable tracks desyncs between draft and published versions:

* **Desync icon** appears if the draft or publish space version has changed.
* Easily republish to update the live version.
* View history, changes, and approver comments at a glance.

---

## [#](#search-filter-on-refined)Search & Filter on Refined

* Label your published pages (e.g., `marketing`, `how-to`, `product-update`).
* Use Refined’s **CQL-based filters** to show labeled pages dynamically.
* Save these searches and embed them into the Refined site homepage or any section.

![Integration with Capable Search](https://help.gocapable.com/images/7b6ec350-9513-4c53-8bcb-0b35bef564c7.webp)

---

## [#](#publishing-dashboard)Publishing Dashboard

Track content lifecycle from a single dashboard:

* **Recently published**
* **Outdated pages**
* **Failed publications**
* **Page status & version history**

Great for content leads or admins managing the knowledge base.

![Confluence Publishing Dashboard](https://help.gocapable.com/images/e663e6f9-08a1-4275-925f-45da845588fe.webp)

---

## [#](#summary)Summary

Using **Capable + Refined** lets your team:

* Eliminate manual publishing processes.
* Maintain compliance and version control.
* Streamline multi-team content collaboration.
* Create consistent, branded content experiences for users inside and outside your organization.