Confluence Tutorial – Stiltsoft https://stiltsoft.com Apps for Atlassian products Tue, 17 Nov 2026 14:25:13 +0000 en-US hourly 1 https://stiltsoft.com/wp-content/uploads/2022/08/icon.png Confluence Tutorial – Stiltsoft https://stiltsoft.com 32 32 10 Confluence Best Practices Your Users Should Know https://stiltsoft.com/blog/10-confluence-best-practices-your-users-should-know/ Tue, 23 Jun 2026 12:22:16 +0000 https://stiltsoft.com/blog/?p=5213 It only takes a few seconds to create a page in Confluence, which is exactly why documentation can get messy. Without a few shared habits, content piles up, pages duplicate,...

<p>The post 10 Confluence Best Practices Your Users Should Know first appeared on Stiltsoft.</p>

]]>
It only takes a few seconds to create a page in Confluence, which is exactly why documentation can get messy. Without a few shared habits, content piles up, pages duplicate, and people stop trusting what they find. The good news is that with a clear set of guidelines, you can keep your documentation organized and genuinely useful. Below are 10 Confluence best practices that cover structure, formatting, and day-to-day usage of Confluence Cloud.

Key takeaways

  • Structure first. Organize spaces by team or project, use consistent naming conventions, and group related pages under clear parent pages.
  • Use templates to keep pages consistent and save people from starting from a blank page every time.
  • Lean on macros — built-in ones cover the basics, and the Atlassian Marketplace fills the gaps.
  • Keep technical docs clean by adding editable LaTeX math formulas instead of pasting screenshots.
  • Avoid duplicate content with Synced blocks instead of copy-pasting.
  • Make your pages interactive so you can update a page from view mode in one click with Handy macros.
  • Label consistently, so the content is easy to group and find.
  • Manage permissions carefully and keep the number of admins small.
  • Train your users. Good structure only holds up if everyone follows the same rules.

1. Plan your space and page structure

Structure is the foundation of any usable documentation, and it works top-down: first your spaces, then the pages inside them.

Spaces are the big folders that hold everything else. A reliable rule of thumb is one space per team (Finance, Marketing) or per project/product — for example, like at our company, Table Filter for Confluence or Awesome Graphs for Bitbucket. Mixing both is fine as long as it’s intentional. What you want to avoid is dozens of overlapping spaces where no one is sure which document belongs where.

Inside each space, set up a clear page tree so content is grouped by subject. When the hierarchy is logical, people find what they need without searching. When it’s flat or chaotic, even good content gets lost. When your tree gets several levels deep, the Child items macro lists subpages, so readers don’t have to expand the whole sidebar to find one.

Use the Child items macro to add structure to your Confluence space

2. Make content easy to find (for people and AI)

Use consistent naming conventions: boring, predictable page and attachment names beat clever ones every time, because they’re easier to scan and to search. The bigger your documentation, the more findability becomes the real test of good structure. In 2026, the most effective knowledge bases are organized around what users are trying to do — clear categories and tightly scoped pages help people, as well as AI like Atlassian Rovo, to find the right answer faster.

3. Use page templates

Confluence ships with a large library of templates — for meeting notes, decision records, how-to articles, product requirements, and much more. The payoff is consistency without the manual work: pages of the same type look and read the same way, and nobody starts from a blank page.

You can also create your own templates and make them available across a space. To point people toward the right starting point, add the Create from template macro to a space home page — one click, and they get a page with the correct structure.

page templates in Confluence Cloud

However, a template only helps if people reach for it, so it’s worth showing new users which ones exist and when to use each.


2020 07 27 15 43 08 Quick Tip 

You can also structure your content as training materials for onboarding or internal education with IZI for Confluence.


4. Take advantage of built-in macros and Marketplace apps

Macros are what make Confluence pages go from static documents to structured, dynamic content. Confluence Cloud includes a solid set of built-in macros, and the Atlassian Marketplace adds hundreds more, from diagrams to advanced table formatting.

A few built-in ones that really help readability: Table of contents on long pages, Expand to hide details not everyone needs, and Anchor links to jump straight to the needed section.

5. Keep technical pages clean

If your team writes anything technical — engineering specs, research notes, finance models, data science docs — you’ll hit one of Confluence’s gaps: there’s no native way to write math formulas. People end up pasting blurry screenshots that look bad and can’t be edited.

LaTeX Math for Confluence helps render LaTeX and AsciiMath formulas directly on the page, with PDF and Word export. You write the syntax, the formula renders cleanly: sharp and editable with a click whenever the numbers change. See how teams can add their first formula in less than a minute.

Keep technical pages clean with LaTeX Math for Confluence

6. Avoid redundant content with synced blocks

Duplicated content is one of the quietest ways a documentation goes stale — the same information can live in three places, and only one ever gets updated.

The best fix in Confluence Cloud is Synced blocks. Turn any content into a synced block once, then reuse it across pages, live docs, and even Jira. You edit it only at the source, and every copy updates automatically, so your messaging stays consistent everywhere it appears. Synced blocks also respect permissions — people only see the content if they have access to the source. The older Excerpt and Insert excerpt macros still work for the same single-source-of-truth idea.

7. Make your pages interactive instead of static

A lot of Confluence content is meant to be used, not just read. When those pages are static, updating them means switching to edit mode for every small change, so updates quietly stop happening and the page goes stale.

Interactive elements fix this by letting people update a page from view mode in one click. Handy Macros for Confluence (Status, Dropdown & Formatting) adds dropdown statuses and date pickers you can switch without editing the page, plus cards, buttons, and progress trackers to make content easier to scan. See how teams use interactive statuses day to day.

Make your pages interactive with Handy Macros for Confluence (Status, Dropdown & Formatting)

8. Label your content

Labels group pages and attachments that share a topic, regardless of where they sit in the page tree. Two habits make them work: create meaningful labels using a short, agreed-upon vocabulary, and use the Filter by label macro to list every page carrying a given label.

Labels also pair neatly with the interactive statuses from Handy Macros for Confluence. If you sync a page’s Handy Status to a label, the label updates automatically every time the status changes.

9. Grant permissions wisely

When too many people have admin rights, everyone configures Confluence for their own corner of the world, and the global structure suffers. A couple of principles keep things healthy:

  • Give users exactly the permissions they need to do their work — no more.
  • Keep the number of space and system admins small.

10. Train your users to adopt Confluence best practices

Structure, templates, labels, and macros only pay off when people actually use them. The most important practice is also the least technical: give your team a few simple guidelines and a living “how we use Confluence” page, and train new users on the basics. When the system is easy to follow, people follow it — and your documentation stays organized as it grows.

FAQ

What are the most important Confluence best practices? The most important Confluence best practices are to keep your spaces and pages well-structured and set clear permissions. Then avoid duplicating content, use templates, and rely on macros — both built-in and from the Atlassian Marketplace. And don’t forget to train your users and give them simple guidelines to follow.

What is the best way to structure a Confluence space? Create one space per team or per project, and within each space nest related pages under clear parent pages. Use the Child items macro on parent pages so readers can navigate deep hierarchies without expanding the whole sidebar. Consistent page structure and naming conventions make the space easy to browse as it grows.

How do I keep a Confluence from getting disorganized? Use templates for consistency, apply a small, consistent set of labels, avoid duplicate content with Synced blocks, and limit the number of admins. Most importantly, train users on these conventions so the structure holds up over time.

Can I write mathematical formulas in Confluence? Confluence Cloud has no native formula editor, but apps like LaTeX Math for Confluence let you render LaTeX and AsciiMath equations directly on the page, with PDF and Word export — so formulas stay sharp and editable instead of living as screenshots.

How can I make Confluence pages more interactive? Combine Confluence’s built-in macros with Marketplace apps like Handy Macros for Confluence, which let you switch statuses and dates from view mode and add cards, buttons, and sliders.

<p>The post 10 Confluence Best Practices Your Users Should Know first appeared on Stiltsoft.</p>

]]>
How to Document Calculations in Confluence https://stiltsoft.com/blog/how-to-document-calculations-in-confluence/ Wed, 10 Jun 2026 13:43:48 +0000 https://stiltsoft.com/?p=15846 Calculations in Confluence are something most teams end up doing twice: once in a spreadsheet where the math actually happens, and again on a Confluence page where the results get...

<p>The post How to Document Calculations in Confluence first appeared on Stiltsoft.</p>

]]>
Calculations in Confluence are something most teams end up doing twice: once in a spreadsheet where the math actually happens, and again on a Confluence page where the results get pasted in for everyone to read. The page shows the numbers, but the calculation behind them stays somewhere else. So the page can show what the values are, but not where they came from.

That gap is worth closing, because a computed value with no visible reasoning invites the question every table eventually gets: where does this number come from? Documenting calculations in Confluence means putting both halves in one place — the live numbers and the formula that explains them — so the page stands on its own. This article walks through how to do that, with a worked example you can rebuild.

Key takeaways

  • Native Confluence can’t document a calculation on its own. It neither performs table calculations nor renders math notation, so you’ll need a couple of Marketplace apps to do both on one page.
  • To run the calculation, use the Table Filter, Charts & Spreadsheets for Confluence app: the Table Spreadsheet macro for Excel-style cell formulas, or the Table Transformer macro for SQL expressions on larger or linked tables.
  • To explain the calculation and render the formula above the table or in table cells, use the LaTeX Math for Confluence app, so a reader sees not just what the number is, but what law it follows and what each symbol means.

Why Confluence can’t document calculations on its own

A Confluence table is static out of the box. It stores whatever you type, but it won’t multiply two columns, sum a row, or derive one value from another. The workaround is to calculate the numbers elsewhere and paste them into your table.

As for math notation, when you try to type a LaTeX formula on the page, the raw backslashes and braces are exactly what you get: P_{\text{out}} = V \cdot I \cdot \eta. The usual fallback is a screenshot, which exports badly to PDF and has to be remade by hand every time an assumption changes.

To close both gaps — to actually run the calculation and show the formula behind it — you need a couple of apps built for it. The good news is they live on the same page and divide the work cleanly.

The setup: one app for the data, one for the formula

The approach uses two Atlassian Marketplace apps, each doing one job. Table Filter, Charts & Spreadsheets for Confluence handles the data side — it turns a static Confluence table into something that can calculate, filter, sort, and total. LaTeX Math for Confluence handles the explanation — it renders the formula above the table as real notation. One does the math, the other explains it — and a reader gets both on a single page instead of taking the numbers on faith.

A worked example: a hardware power budget

To make this concrete, take a hardware power budget — the kind of table an electronics or robotics team keeps to track how much power each component draws.

Component

Voltage (V) 

Current (A) 

Efficiency 

Output power (W)

MCU

3.3

0.05

0.90

0.149

Sensor array

5.0

0.12

0.85

0.510

Drive motor

12.0

1.40

0.80

13.440

Voltage and Current come from the design; Efficiency comes from each component’s datasheet; and the Output power column isn’t entered – it’s calculated from the other three.

This is exactly where the two halves come together. The number in the Output power column has to be computed (native Confluence can’t do that), and the formula above it has to be rendered (native Confluence can’t do that either).

How to run the calculation: the Table Spreadsheet macro

The most familiar way to calculate a column is the Table Spreadsheet macro, which puts an Excel-like sheet right on the page — same cell references, same formulas you’d write in Excel.

  1. After installing the app, edit the page, type /Table Spreadsheet, and insert the macro.
  2. Enter your columns and rows in the sheet.
  3. In the first cell of the Output power column, type the formula as you would in Excel and press Enter.
  4. Copy the formula down so every row calculates.
  5. Save your edits.

 Table Spreadsheet macro in Confluence showing a power budget with voltage, current and efficiency columns and an effective power column calculated by an Excel-style cell formula

Once the spreadsheet is saved, the data is ready for more than just calculation. Right inside the Table Spreadsheet macro, you can sort and filter rows, add a pivot table, or build a chart from your numbers.

How to explain calculations in Confluence and add the formula: the LaTeX Math macros

To explain the calculations in Confluence behind your data and add the formula above the table, use the LaTeX Math for Confluence macros:

  1. Place the cursor above the table, type /latex, and choose the LaTeX Block Formulas macro.
  2. Enter the formula in standard LaTeX.
  3. Save. It renders as a real equation.

LaTeX Math for Confluence block macro rendering the output power formula as proper math notation on a Confluence page

Tip: For a single symbol inside a sentence or table cell, you can use the LaTeX Inline Formulas macro.

Now the spreadsheet computes and holds the live power figures, and the equation above them states the law they follow.

Confluence page documenting a calculation with LaTeX Math and Table Filter — the rendered formula with its explanation above and the Table Filter data table with the computed column below

For larger or linked data: the Table Transformer macro

When the data is large, pulled from another table, or needs to be joined before the math, the Table Transformer macro is the stronger tool. Instead of a cell formula, it adds a computed column with an SQL expression.

For the same power budget:

SELECT *, ('Voltage (V)' * 'Current (A)' * 'Efficiency') ->toFixed(3) AS 'Output power (W)' FROM T1

Table Transformer macro in Confluence with an SQL query adding a calculated output power column to the table

The parentheses build the calculation, AS names the new column, and ->toFixed(3) rounds to three decimals. Table Spreadsheet is friendlier for hand-entered data; Table Transformer wins on large or linked tables. Either way, the calculation runs on the data side, and LaTeX Math explains it above.

The same pattern works for calculations in Confluence far beyond engineering

A power budget is just one shape of the idea. Any field that keeps a formula behind a table fits the same structure: calculate the column with Table Filter, Charts & Spreadsheets for Confluence, and explain it with LaTeX Math for Confluence.

Getting started

Both apps are on the Atlassian Marketplace for Confluence Cloud and work on the same page:

If you already use Table Filter, Charts & Spreadsheets for Confluence, adding the LaTeX Math for Confluence app takes about five minutes, and your first formula takes about a minute after that.

FAQ

How can I document calculations in Confluence?

To document calculations in Confluence and put the data and the formula on the same page, you can use Table Filter, Charts & Spreadsheets for Confluence to calculate the data, and LaTeX Math for Confluence to render the formula as proper notation above the table. Native Confluence does neither on its own, which is why both apps are needed.

Can native Confluence perform table calculations?

No. A standard Confluence table is static — it stores values but won’t multiply columns, sum rows, or derive one value from another. Calculations need an app like Table Filter, Charts & Spreadsheets for Confluence, whose Table Spreadsheet macro runs Excel-style formulas or Table Transformer macro runs SQL expressions.

Does the formula export to PDF?

Yes, you can export formulas rendered with LaTeX Math for Confluence to PDF. Equations render correctly through Confluence’s built-in PDF export and Scroll PDF Exporter, appearing as proper notation rather than plain text or broken images.

Does LaTeX Math for Confluence calculate the numbers for me?

No, LaTeX Math for Confluence renders the formula to explain the data; it doesn’t perform the arithmetic. The numbers come from the Table Spreadsheet or the Table Transformer macros and are stored in the table.

<p>The post How to Document Calculations in Confluence first appeared on Stiltsoft.</p>

]]>
How to Merge Tables in Confluence and Reuse Content for Cross-Team Reporting https://stiltsoft.com/blog/how-to-merge-tables-in-confluence-reuse-content/ https://stiltsoft.com/blog/how-to-merge-tables-in-confluence-reuse-content/#comments Fri, 24 Apr 2026 11:55:53 +0000 https://stiltsoft.com/blog/?p=7397 Reporting in Confluence quickly becomes complicated when the data comes from multiple sources. What starts as a simple update can turn into a patchwork of scattered tables, Jira work items,...

<p>The post How to Merge Tables in Confluence and Reuse Content for Cross-Team Reporting first appeared on Stiltsoft.</p>

]]>
Reporting in Confluence quickly becomes complicated when the data comes from multiple sources. What starts as a simple update can turn into a patchwork of scattered tables, Jira work items, and spreadsheets that need constant manual cleanup. The bigger the reporting workflow gets, the easier it is for the output to drift out of sync with the sources.

This article shows a more reliable way to merge tables in Confluence and reuse content more systematically across pages, spaces, and teams. Instead of manually merging tables in Confluence every time or using external tools, you can create a repeatable workflow: collect source data from different places, turn it into a report-ready dataset, build report views, and reuse them across pages.

Key takeaways

  • Scattered source data makes reporting in Confluence fragmented and ineffective; manual copy-pasting creates static outputs that quickly drift out of sync.

  • Consolidated reporting turns that process into a repeatable workflow inside Confluence.

  • Table Filter, Charts & Spreadsheets for Confluence supports each step: collecting, transforming, building, and reusing.

  • The result is a single report-ready dataset that can power filtered views, summaries, and charts, all of which can be reused across pages.

Why merging tables in Confluence often feels like a hassle

If you regularly build reports across teams, you probably know the pattern.

One team keeps a project status table. Another one keeps release-related data in a Jira project. A third exports their Jira work items into a separate page before every meeting. Then you have to merge everything manually, fix formatting, and remove duplicates, hoping you are looking at the latest version.

Instead of putting together a report, you are chasing data all over the place. But the fact that it sits in different places is only part of the problem. The other is that when you copy and paste it, the data quickly goes stale, leaving you with yet another dead document.

This is hardly an edge case. Our customer research points to the same problem: bringing data together from multiple sources and reusing it on other pages often requires more manual work than it should.

Gartner reported in 2023 that the average desk worker uses 11 applications to complete their tasks, up from six in 2019. In 2026, with even more tools in the mix, this feels increasingly unacceptable.

Luckily, there’s a better approach. Instead of manually chasing scattered data and rebuilding reports every time something changes, you can create a workflow that pulls everything together and keeps the report (and any pages that reuse it) updated automatically.

For this kind of workflow, the Table Filter, Charts & Spreadsheets for Confluence app adds capabilities that Confluence lacks out of the box. Its macros are designed to support the entire reporting process, helping you bring data together, turn it into a usable dataset, and reuse the results where they matter.

How to combine and reuse data in Confluence for different reporting needs

There is more than one way to build a reporting workflow from multiple data sources. The right setup depends on how your data is structured and what kind of output you need. The use cases below introduce the main setups, following the same core flow:

  • Collect the relevant inputs

  • Transform them into a usable dataset

  • Build the views people actually need

  • Reuse that output where it adds value

Infographic titled “A 4-step reporting workflow in Confluence” showing four connected stages: collect relevant inputs, transform them into a usable dataset, build the views people need, and reuse the output across pages. Each step appears in a separate card with icons for data sources, table transformation, report views, and reused outputs.
How teams can move from fragmented inputs to reusable reports in Confluence.

Use case 1: Merge tables from multiple pages

Best for

Use this when similar tables are maintained on different Confluence pages, but you need a single combined report. For example, when you want to:

  • roll up budgets or expenses

  • consolidate tool inventories across teams

  • build an employee list across a department or division

  • track progress across multiple projects or teams

Typical problem

Different teams keep their own status, budget, risk, or KPI tables on separate pages. The structure is close enough to combine, but every time you need a roll-up, you end up copying rows into a master table, rebuilding summaries, and checking whether the source pages have changed again.

How to do it

Collect

Use the Table Excerpt macro on each source page to mark the tables you want to reuse, then collect them on a reporting page using Table Excerpt Include. That lets you bring matching tables together without duplicating sources of truth.

Transform

Once the source tables have been collected into a single view, you can further shape the result in Table Excerpt Include: add extra metadata fields such as the page creation date or labels, or transpose the source tables if that makes the final report easier to work with.

Build

From there, shape the combined dataset into the right output. Use the Table Filter macro for a more focused working view; Pivot Table for a roll-up by team, status, or period; and Chart from Table if the result is easier to read visually.

Reuse

Once that output is ready, you can reuse it on other pages with Table Excerpt and Table Excerpt Include. This way, your reporting workflow supports several audiences.

What you get

You get a single consolidated report built from multiple source pages, while each team retains ownership of its data where it already lives. That reduces copy-paste work, keeps local maintenance intact, and makes the roll-up easier to trust.

Illustration of merge tables in Confluence: two department expense tables on separate Confluence pages (Marketing and Engineering) being combined into one aggregated expense report, with a pivot table added to summarize the consolidated data.
Two tables with the same structure from different Confluence pages are merged into a single consolidated report, then summarized in a pivot table for a higher-level view.

Use case 2: Join related tables by a shared field

Best for

Use this when you have two related Confluence tables connected by a shared field and want to combine them into a single report. This often applies when you need to:

  • match tasks with owner details kept in a separate table

  • connect assets with location or category data

  • combine project records with reference information stored elsewhere in Confluence

Typical problem

You may have one table with project data and another with reference fields tied to the same records. Without a proper join, you either keep jumping between them or export both to another tool just to combine a few columns.

How to do it

Collect

If the tables are not already on the same page, pull them in from other pages using Table Excerpt and Table Excerpt Include first.

Transform

Use the Table Transformer macro with its Lookup Tables preset to match rows on that shared field and combine the related values into a single output. This is what turns two connected datasets into a single report-ready table so the shared information appears together rather than being split across separate sources.

Build

After that, build the kind of report stakeholders need. Use Table Filter to surface the part of the joined table that matters for the report. Create a pivot table, if the goal is to summarize the enriched data. Use Chart from Table when a visual summary is more useful than raw rows.

Reuse

Once the joined output is ready, wrap it in Table Excerpt and surface it on other pages with Table Excerpt Include, rather than recreating the same lookup logic in several places. That lets one enriched dataset feed multiple reports, dashboards, or stakeholder pages without repeating the join.

What you get

You get one readable report instead of two separate tables. The related values are brought together in a single reporting view, making the full picture easier to read.

Illustration showing two related Confluence tables (Team Members and Project Assignments) joined into one combined table by the shared Member ID field using Table Transformer.
Two related tables are joined on a shared field to create a reporting view that brings the connected data together in one place.

Use case 3: Bring together Jira-based data

Best for

Use this when the reporting problem involves Jira-based tables and the result needs to be easier to read, summarize, or reuse inside Confluence. It’s useful when you want to:

  • combine work item data with linked dependencies

  • roll up delivery information for stakeholder reporting

  • bring related Jira outputs into one page for project reviews, release tracking, or cross-team coordination

Typical problem

You may have one Jira-based table with the main work items and another with related records that matter for reporting. The reporting view is fragmented. People end up switching between Jira outputs, manually following work item links, or exporting data just to reconstruct the picture elsewhere.

How to do it

Collect

Start by pulling the Jira-based tables you want to work with onto the same reporting page, typically using the Jira work items macro.

Transform

Use Table Transformer to combine those Jira-based datasets into a single usable output. In simpler cases, this may involve a more standard transformation. When the relationship is harder to model with a simple lookup, this macro also gives you room for custom SQL logic. That opens up virtually any custom reporting setup you need — for example, bringing Jira data from 20 different projects into a single report.

Build

Then turn the transformed Jira-based data into the kind of reporting layer the page needs. In some cases, the right output is still a detailed table, refined with Table Filter. In others, a summarized view built with Pivot Table or a visual snapshot from Chart from Table makes the result easier to review and share.

Reuse

Once the output is ready, wrap it in Table Excerpt and reuse it with Table Excerpt Include on the page where the broader reporting story belongs. That lets you keep the data and decisions together without having to rebuild the reporting layer in multiple places.

What you get

You get Jira-based reporting that is easier to review and reuse in Confluence, with a single, clearer view instead of several disconnected outputs.

Illustration showing two Jira issue tables in Confluence being combined with Table Transformer: one table contains original issues with linked issue keys, the other contains detailed records for those linked issues, and the result is one report that brings both together.
A Jira-based report can combine original issues with data from their linked issues, so related records appear together in one view instead of across separate tables.

Use case 4: Build spreadsheet-based views

Best for

Use this when the work calls for spreadsheet-style calculations, and you want to handle them in Confluence rather than exporting to Excel or Google Sheets. Common examples include:

  • importing external data and continuing the analysis inside Confluence

  • replacing an Excel or Google Sheets workflow with a spreadsheet that stays on the page

  • reusing calculated metrics, ranges, or selected cells across project pages or reports

Typical problem

Keeping spreadsheet work in a separate tool adds an extra layer of back-and-forth, while copying the results into Confluence turns them into another static snapshot.

How to do it

Collect

Let’s say part of the reporting data sits outside Confluence and needs to be pulled in before you can work with it on the page. Bring it into Confluence using the Table from CSV macro, then convert it into a spreadsheet with Spreadsheet from Table. This gives you a spreadsheet-style workspace on the page, so you can keep working with the data in Confluence instead of switching back and forth between Confluence and Excel or Google Sheets.

Transform

Process the data the way you would in a spreadsheet: apply formulas, calculate metrics, and prepare the specific values you want to reuse.

Build

At that point, the spreadsheet itself may already be the main working view. But if the goal is to surface only part of it, define the exact cell range or sheet that should be shown elsewhere. That way, you do not have to expose the entire spreadsheet just to reuse one result.

Reuse

Use the Table Spreadsheet Include macro to display the excerpt on other Confluence pages. Any updates made in the spreadsheet are reflected in the reused output, sparing you the need to manually replace the same data on every page.

What you get

You keep spreadsheet work in Confluence, making the results easier to reuse across pages. Instead of maintaining the calculations in one place and copying the outputs somewhere else, you can work in a spreadsheet and surface the right parts where they are needed.

Explore more Confluence reporting use cases

Move from copy-paste reporting to a reusable workflow

Done well, consolidated reporting helps make Confluence the center of teamwork. It gives teams three things at once: data that stays close to its context, a workflow that does not have to be rebuilt every time, and reports that are easier to scale and trust.

Once the source tables are reusable and the reporting logic is centralized, the report ceases to be a one-off artifact. With Table Filter, Charts & Spreadsheets for Confluence, you shape it once and reuse the output in the form each stakeholder needs.

Instead of constantly recreating summaries and pasting static snapshots into pages, you keep the reporting flow connected to the source from start to finish. The result is less manual rework, fewer conflicting versions, and more confidence that people are looking at the right data in the right context.

Graphic titled “How to Install Apps from the Atlassian Marketplace,” showing a four-step flow: go to the Marketplace, find a solution, ask a Confluence admin to install the app, and use the new capabilities.
Installing the app is easy (assuming your Confluence admin is in a good mood).

“Start my free trial” button.

FAQs

How do I merge tables in Confluence?

Use Table Excerpt to mark each source table, then collect them on one page with the Table Excerpt Include macro. If the tables share the same structure, you can show them as one report table. If they do not, use Table Transformer to merge and standardize them.

How can I embed a table from another Confluence page?

Wrap the source table in the Table Excerpt macro, then display it on another page with Table Excerpt Include. This lets you reuse the same table without copying it manually.

How do I include a table from another Confluence page?

Use macros from the Table Filter, Charts & Spreadsheets for Confluence app available on the Atlassian Marketplace: Table Excerpt on the source page and Table Excerpt Include on the target page. These macros let you reuse the same table across pages while keeping it connected to the original source.

Can I insert a table from another page in Confluence?

Yes, with the Table Excerpt and Table Excerpt Include macros, you can surface a table from another page directly on the page where you need it.

How do I link a table from another Confluence page without duplicating it?

Instead of copying the table, reuse it with the Table Excerpt and Table Excerpt Include macros. That way, updates made to the source table can flow through to the reused version.

How do I display content from another Confluence page?

If you need to display table-based content, the Table Excerpt and Table Excerpt Include macros from Table Filter, Charts & Spreadsheets for Confluence let you reuse it across pages. This is especially useful when the same data needs to appear in multiple reports or dashboards.

Can I embed content from another Confluence page?

Yes, wrap the source in the Table Excerpt macro and pull it into another page using Table Excerpt Include.

How do I display content from another page in a report?

You can collect source tables from multiple pages with Table Excerpt Include, then use macros such as Table Filter, Pivot Table, or Chart from Table to turn that reused content into a live report view.

Can I build one report from tables stored on different pages?

Yes, mark the source tables with the Table Excerpt macro, collect them with Table Excerpt Include, and, if needed, use Table Transformer to merge them into one report-ready dataset. This way, you can build live reports from reused Confluence tables instead of copying and pasting them into one page.

How do I reuse the same table on multiple Confluence pages?

Use the Table Excerpt macro on the source page and Table Excerpt Include wherever else the table needs to appear. This avoids duplicate maintenance and keeps the workflow easier to manage.

<p>The post How to Merge Tables in Confluence and Reuse Content for Cross-Team Reporting first appeared on Stiltsoft.</p>

]]>
https://stiltsoft.com/blog/how-to-merge-tables-in-confluence-reuse-content/feed/ 2 Confluence Tutorial - Stiltsoft nonadult
Step-by-step Guide for Creating Math Formulas in Confluence (with Videos) https://stiltsoft.com/blog/guide-for-creating-math-formulas-in-confluence/ Thu, 19 Mar 2026 12:09:16 +0000 https://stiltsoft.com/?p=15106 For many teams, Confluence becomes the central place for documentation. Engineers write technical specs, analysts document models, and data scientists explain algorithms. At some point, all of them run into...

<p>The post Step-by-step Guide for Creating Math Formulas in Confluence (with Videos) first appeared on Stiltsoft.</p>

]]>
For many teams, Confluence becomes the central place for documentation. Engineers write technical specs, analysts document models, and data scientists explain algorithms. At some point, all of them run into the same challenge: how to write properly looking math formulas in Confluence?

Instead of a single long tutorial, we decided to create a series of short video tutorials that show the most common ways engineers and technical teams use LaTeX in Confluence.

This guide brings those videos together in one place.

Getting Started with LaTeX in Confluence

If you’ve never used LaTeX in Confluence before, the first step is simply understanding how formulas can appear on a page.

The thing is that Confluence doesn’t support LaTeX syntax by default. Teams can use screenshots or copy-paste hacks, but every edit will become a mini-project that slows the team down and breaks the flow of documentation. That’s why the way most teams prefer to add beautifully formatted math formulas to their pages is by using an app from the Atlassian Marketplace that supports LaTeX rendering. One of them is the LaTeX Math for Confluence app, which we will refer to in our guide and videos.

To get started with math formulas in Confluence, you need to choose a secure LaTeX app that seamlessly integrates with Confluence and install it from the Atlassian Marketplace. After that, you can easily add any formula using the app’s macros: open the page, put the cursor where you want to see your formula, type /latex, and choose the inline or block macro to add the formula within the text or as a standalone expression, respectively.

This short tutorial walks through these basics and shows how you can start adding mathematical formulas to your documentation in just a few clicks.

For a full written overview, you can also see our guide on adding LaTeX math to Confluence in 60 seconds.

Going Beyond the Basics

Once you understand how to add formulas into your Confluence documentation, the next step is writing full mathematical expressions. The following video tutorials explain how to write the most common math expressions in LaTeX.

LaTeX syntax for summations, integrals, and math functions in Confluence

LaTeX syntax for matrices in Confluence

LaTeX syntax for arrays in Confluence

LaTeX syntax for piecewise functions in Confluence

For those who prefer written guidance, our article How to Write LaTeX Math Equations in Confluence collects best practices, formatting rules, and examples that complement the video tutorials.

Seeing the Full Picture

If you would like to see an overview covering the full process, starting from installing the LaTeX Math for Confluence app to writing math formulas, you are welcome to look at our comprehensive tutorial on how to use formulas in Confluence.

Making the Shift to Math Formulas in Confluence with LaTeX

You don’t need to rely on screenshots or some copy-paste hacks to add formulas to your Confluence pages. With a secure LaTeX Math for Confluence app, you will forget about broken formatting, unclear images, or the inability to edit formulas you’ve added before.

Try LaTeX Math for Confluence free for 30 days and see how your math formulas in Confluence transform from a chore into a seamless, collaborative experience.

<p>The post Step-by-step Guide for Creating Math Formulas in Confluence (with Videos) first appeared on Stiltsoft.</p>

]]>
Confluence Tutorial - Stiltsoft nonadult
How to Use Spreadsheets in Confluence (Without Exporting to Excel or Google Sheets) https://stiltsoft.com/blog/how-to-use-spreadsheets-in-confluence/ https://stiltsoft.com/blog/how-to-use-spreadsheets-in-confluence/#comments Wed, 11 Mar 2026 07:00:38 +0000 https://stiltsoft.com/blog/?p=8558 Confluence tables are fine. Until you need to do spreadsheet work — the kind you automatically reach for in Excel or Google Sheets. The catch is, Confluence doesn’t offer spreadsheet...

<p>The post How to Use Spreadsheets in Confluence (Without Exporting to Excel or Google Sheets) first appeared on Stiltsoft.</p>

]]>
Confluence tables are fine. Until you need to do spreadsheet work — the kind you automatically reach for in Excel or Google Sheets. The catch is, Confluence doesn’t offer spreadsheet functionality out of the box. But this doesn’t mean you have to export anything.

In this guide, we’ll break down the main ways teams handle spreadsheets in Confluence and show a few practical workflows using third-party macros.

Key takeaways

  • Native Confluence tables aren’t Excel: They don’t support spreadsheet-style formulas, calculations, and other familiar features.

  • You have three main options for using spreadsheets in Confluence: embed external files with Smart Links, use a Marketplace spreadsheet app to work directly in Confluence, or choose a holistic app such as Table Filter, Charts & Spreadsheets for Confluence if you need real analysis and reporting, not just display.

  • A super app like this covers the most common spreadsheet workflows in Confluence: creating and editing spreadsheets, importing an existing Excel file, converting native Confluence tables (including Jira work items) into spreadsheets, and reusing a spreadsheet across multiple pages within an instance.

Why would you need Excel-like spreadsheets in Confluence?

Because native Confluence tables only go so far, many teams end up needing Excel-like spreadsheets. Here are the most common scenarios where that comes up:

  • You need formulas and calculations, not just a table that displays data.

  • You rely on spreadsheet-only features Confluence tables can’t replicate, such as conditional formatting and dropdown lists.

  • You prefer a predictable grid interface you already know.

  • Your data is scattered across multiple Excel files and shared via email, so you want to consolidate it and improve team workflows.

  • You need multiple people to contribute at the same time, without passing files back and forth or reconciling edits later.

  • You need reliable versioning so it’s easy to see what changed and who changed it, and roll back if needed.

  • You want spreadsheet data to sit alongside the project context (specs and documentation) rather than in a separate file.

  • You want to analyze and present the data without exporting to Excel or Google Sheets, using things like filtering, pivots, and charts in the same workspace.

Screenshot of an Excel-like spreadsheet embedded in a Confluence page using the Table Filter, Charts & Spreadsheets app, highlighting formulas, conditional formatting, and multiple sheets.
Excel-like spreadsheet functionality in Confluence, including formulas, conditional formatting, and multiple sheets.

Overview of options for spreadsheets in Confluence

When teams say they need spreadsheets in Confluence, it usually comes down to whether they want to embed an external sheet, create spreadsheets directly in Confluence, or build a broader reporting workflow around their data.

Below is a quick overview of the three most common options, along with the downsides you should know upfront.

Option 1: Confluence’s Smart Links

If your spreadsheet already lives in Google Drive, OneDrive, or SharePoint, the fastest way is to paste its link into Confluence using a Smart Link so the content appears right on the page, without leaving the platform.

Downsides: Confluence doesn’t inherit permissions from non-Atlassian apps. A user needs to be logged in to Google or Microsoft 365 and have access to the embedded sheet to view it, which can create unwanted friction when sharing.

Confluence Smart Link preview for a Google Sheets URL, showing a “Connect to Google” prompt to enable an interactive embed.
A user is blocked from the sheet because they aren’t logged in to Google.

Option 2: Spreadsheet apps from the Atlassian Marketplace

There’s a growing category of Marketplace apps that focus specifically on giving Confluence an Excel-like interface. These can be useful for teams that want spreadsheets to live inside Confluence rather than as embedded external files.

Downsides: If you need broader reporting capabilities, you may end up stitching together multiple apps or workarounds and quietly making your Confluence admins hate you.

Option 3: A single super app that covers spreadsheets and much more

If you want a fully-fledged reporting toolkit without creating app sprawl, consider a Confluence app like Table Filter, Charts & Spreadsheets that provide a more holistic approach to data analysis and reporting.

In the spreadsheets lane specifically, you get three macros that cover most real-life scenarios:

  • Table Spreadsheet: Creating and editing an Excel-like spreadsheet directly in Confluence.

  • Spreadsheet from Table: Converting an existing Confluence table or a table generated by another macro (e.g., Jira work items) into a spreadsheet view.

  • Table Spreadsheet Include: Reusing a range from one spreadsheet on other pages.

Downsides: It’s a powerful toolkit, which means it may take a bit of setup and learning, but it’s the good kind of complexity (the kind you only learn once, and it pays off).

How to work with spreadsheets in Confluence

Below are a few practical, day-to-day spreadsheet workflows teams run in Confluence when native tables aren’t enough, using macros from Table Filter, Charts & Spreadsheets for Confluence.

Create and edit an Excel-like spreadsheet

Use the Table Spreadsheet macro to add a spreadsheet to your Confluence page and work with it like you would in Excel. Use formulas, calculations, and other spreadsheet features you simply can’t recreate with native Confluence tables, like conditional formatting and dropdown lists for consistent data entry.

With the same macro, you can also import an existing Excel spreadsheet and continue with calculations in Confluence.

Turn a Confluence table or Jira work items into a spreadsheet inside Confluence

Wrap an existing Confluence table (or a table generated by another macro) in a spreadsheet view so you can run formulas, validate totals, and do quick analysis directly on the page, without rebuilding the data manually.

Here’s how to do it:

  1. Add the Spreadsheet from Table macro to your Confluence page.

  2. Place the source table inside the macro body, and it will be rendered as an Excel-like spreadsheet.

In the same way, you can insert a Jira work items table on a Confluence page, then convert that table into a spreadsheet so you can calculate, sort, and work with that data in a familiar Excel-like layout.

Reuse spreadsheet ranges across Confluence pages without copy-paste

Create one source spreadsheet and include specific sheets or cell ranges on other pages to keep dashboards and status pages in sync. Updates happen once in the master spreadsheet, and every included snippet changes in real time.

Here’s how it works:

  1. Create a source spreadsheet on a Confluence page with the Table Spreadsheet macro and put your master data there.

  2. On another page, insert the Table Spreadsheet Include macro.

  3. In the macro settings, select the source spreadsheet and specify what to include (sheet and range).

Less exporting, more shared visibility

When spreadsheet work moves into Confluence, the biggest win is less hassle. The data stays on the same pages where your team plans and reviews progress, so you’re not exporting anything to Excel, emailing files around, or rebuilding the same view every time something changes. With the right setup, spreadsheets become part of your Confluence workflow: editable and reusable across pages.

Graphic titled “How to Install Apps from the Atlassian Marketplace,” showing a four-step flow: go to the Marketplace, find a solution, ask a Confluence admin to install the app, and use the new capabilities.
Installing the app is easy (assuming your Confluence admin is in a good mood).

“Start my free trial” button.

FAQs

How do I add a spreadsheet in Confluence?

In practice, you can embed a spreadsheet in Confluence from Google Drive or Microsoft 365 using Smart Links, or add an Excel-like spreadsheet directly to a page using a third-party app such as Table Filter, Charts & Spreadsheets, which provides Confluence macros for spreadsheet functionality.

How do I create a spreadsheet in Confluence?

There’s no Excel macro out of the box, so if you want the spreadsheet to behave like Excel inside Confluence, create it on a page using an Excel-like macro such as Table Spreadsheet. If you already have the file in Google Sheets or Excel Online and only need to display it on the page, Smart Links are often the fastest path.

How do I create an Excel-like spreadsheet document in Confluence?

If you mean a spreadsheet that lives on the page (not just an attachment preview), create it directly on the platform using a Confluence spreadsheet macro. With Table Filter, Charts & Spreadsheets, this is typically done in Table Spreadsheet, which provides a familiar grid for formatting, structured data entry, and spreadsheet formulas in Confluence.

How do I edit an Excel spreadsheet in Confluence?

It depends on how the spreadsheet is added. If it’s embedded via Smart Links, you’re editing the source file in Google or Microsoft 365, and access is controlled there. If you add a spreadsheet directly on the page using an Excel-like macro (for example, Table Spreadsheet), you can edit cells, formulas, and formatting without leaving Confluence. If you’re converting an existing Confluence table into a spreadsheet view, Spreadsheet from Table is the macro typically used for that workflow.

How do I link a dynamic spreadsheet in Confluence?

If “dynamic” means the Confluence page should always show the latest version of an external file, Smart Links keep the embed tied to the source spreadsheet (as long as viewers can access it). If you want the data to live in Confluence but appear across multiple pages, a common approach is to maintain one source spreadsheet and reuse parts of it elsewhere. In Table Filter, Charts & Spreadsheets, this is what Table Spreadsheet Include is designed to do: show a selected sheet or cell range from a source spreadsheet on other pages.

How do I make a spreadsheet editable in Confluence?

To make it editable inside Confluence, you generally need an Excel-like spreadsheet macro, such as Table Spreadsheet, on the page rather than an embed. The Table Spreadsheet macro covers the “create and edit directly on the page” use case. If your starting point is a Confluence table or a table generated by another macro, Spreadsheet from Table gives you a spreadsheet view you can work with.

How do I use spreadsheets in Confluence?

Most teams end up using spreadsheets in Confluence in three workflows. They create and edit spreadsheets directly on pages with Table Spreadsheet, they convert existing tables into spreadsheet views with Spreadsheet from Table (including tables generated by other macros), and they reuse spreadsheet ranges across pages with Table Spreadsheet Include to keep dashboards and status pages consistent with a single source. These macros are available as part of the Table Filter, Charts & Spreadsheets for Confluence bundle.

Where can I find more Confluence use cases and practical examples?

Explore the Confluence Use Case Library for practical examples of dashboards, Jira reporting, searchable catalogs, resource planning, and spreadsheet workflows. Each use case explains the problem, the result, and how the solution is built.

<p>The post How to Use Spreadsheets in Confluence (Without Exporting to Excel or Google Sheets) first appeared on Stiltsoft.</p>

]]>
https://stiltsoft.com/blog/how-to-use-spreadsheets-in-confluence/feed/ 6 Confluence Tutorial - Stiltsoft nonadult
How to Export LaTeX to PDF in Confluence (Without Broken Formulas) https://stiltsoft.com/blog/how-to-export-latex-to-pdf-in-confluence/ Tue, 03 Mar 2026 16:01:28 +0000 https://stiltsoft.com/?p=15001 If you’ve ever tried to export LaTeX to PDF in Confluence, and instead of formulas got something like “formula rendering error”, you’ve probably faced the same issue many people in...

<p>The post How to Export LaTeX to PDF in Confluence (Without Broken Formulas) first appeared on Stiltsoft.</p>

]]>
If you’ve ever tried to export LaTeX to PDF in Confluence, and instead of formulas got something like “formula rendering error”, you’ve probably faced the same issue many people in the Atlassian Community still report in 2026:

“The app displays formulas correctly on pages, but it doesn’t support LaTeX PDF export in Confluence.”

This guide explains exactly why it happens on Confluence Cloud, which LaTeX apps support reliable PDF export, and how to export your pages with the built-in Confluence exporter or Scroll Exporter apps — including how to migrate from a LaTeX app that doesn’t support PDF export.

Why LaTeX formulas break during PDF export in Confluence Cloud

Most users assume that exporting a Confluence page to PDF is essentially the same as printing what’s on the screen. If the formula renders correctly in the browser, surely it should render correctly in the exported document.

But Confluence Cloud doesn’t work that way.

When you export a page to PDF, Confluence doesn’t take a visual snapshot of the browser view. Instead, the system re-renders the entire content in a separate export pipeline. If the LaTeX app you use isn’t built to plug into that pipeline, the formula macros are either replaced with an error placeholder or skipped.

That’s why the root cause is rarely LaTeX syntax or your formula. It’s almost always that the LaTeX app you have installed wasn’t designed with the Cloud export pipeline in mind.

A simple way to export LaTeX to PDF in Confluence

When looking for apps that can render formulas in Confluence, pick the one that works well with Confluence Cloud and supports exporting LaTeX formulas to PDF.

One of them is the LaTeX Math for Confluence app. It is built on Atlassian Forge, which means it runs directly on Atlassian’s infrastructure, uses native Atlassian components for a smooth experience, and is fully compatible with Confluence Cloud.

The app supports not only PDF export, which works in Confluence by default, but also PDF, Word, and HTML export via third-party apps: Scroll PDF Exporter, Scroll Word Exporter, and Scroll HTML Exporter for Confluence.

The usage of the LaTeX Math for Confluence app is a simple way to export LaTeX to PDF in Confluence

How to Export LaTeX from Confluence to PDF

Let’s have a quick look at how to export LaTeX formulas from Confluence to PDF with the LaTeX Math for Confluence app. (Spoiler: it’s actually very simple.)

Step 1: Add your LaTeX formula

After installing LaTeX Math for Confluence from the Atlassian Marketplace:

  1. Open the Confluence page where you want the formula
  2. Type /latex and select the macro you need:
    • LaTeX Inline Formulas — for equations within a sentence
    • LaTeX Block Formulas — for standalone equations
  3. Enter your LaTeX code in the modal editor
  4. Save — your formula renders instantly on the page

How to add your LaTeX formula with the help of the LaTeX Math app

Need help with syntax? See how to write LaTeX equations in Confluence.

Step 2: Export using Confluence’s built-in PDF exporter

  1. Open the page containing your LaTeX formulas
  2. Click the More actions menu (three dots, top-right)
  3. Select Export → Export to PDF
  4. Download the file

That’s it. All LaTeX formulas appear in the exported PDF exactly as they do on the page.

LaTeX PDF export visual

Step 2 (alternative): Export LaTeX from Confluence using Scroll PDF, Word, or HTML Exporter

If your team uses Scroll PDF Exporter or Scroll Word Exporter, by K15t for advanced templates, LaTeX Math for Confluence works with them out of the box:

  1. Open the page with your formulas
  2. Click the More actions menu → Apps
  3. Select one of:
    • Export with Scroll PDF Exporter
    • Export with Scroll Word Exporter
    • Export with Scroll HTML Exporter
  4. Configure your export settings and run

All LaTeX equations are preserved in the resulting PDF, Word, or HTML document.

Migrating from another LaTeX app that doesn’t export to PDF

If you currently have a LaTeX app installed that fails on PDF export, you don’t have to rewrite your formulas to switch. LaTeX Math for Confluence supports migration of equations from other LaTeX apps for the most common formula types — our team helps with the transfer to ensure your specific setup works as expected.

The high-level flow:

  1. Install LaTeX Math for Confluence from the Marketplace (30-day free trial, no credit card)
  2. Follow our documentation or contact our team — we’ll walk you through the migration of your existing equations
  3. Verify that a few sample pages export correctly to PDF
  4. Uninstall the previous app

The most common reason teams switch is exactly the one this article opens with: PDF export not working on Cloud.

Final Thoughts

Exporting LaTeX to PDF in Confluence Cloud isn’t difficult — it just requires a LaTeX app that was actually built for the Cloud export pipeline. If your current app fails on export, it’s almost always a Cloud architecture limitation, not a problem with your formulas.

LaTeX Math for Confluence is built on Atlassian Forge specifically for Confluence Cloud, supports the built-in PDF exporter and Scroll Exporter apps, and includes a migration path from other LaTeX apps.

Start your 30-day free trial, and no longer worry about the “it worked on the page but disappeared in the PDF” scenario. Or contact our team if you’re migrating from another LaTeX app and want to walk through the equation transfer with us.

More guides on LaTeX in Confluence

If you are just getting started with LaTeX in Confluence, here are some guides that will help you avoid the most common mistakes:

FAQ

Does Confluence Cloud support LaTeX export to PDF natively?

Confluence Cloud has a built-in PDF export, but it doesn’t render LaTeX — you need a LaTeX app installed. The app must be designed to support PDF export, like LaTeX Math for Confluence by Stiltsoft. Not every LaTeX app on the Marketplace does this.

Why do my LaTeX formulas work on the Confluence page but not in the exported PDF?

Confluence Cloud re-renders the page during export rather than capturing the browser view. If the LaTeX app you’re using only renders formulas in the browser (client-side) and doesn’t support the exporting process, the export falls back to error placeholders or just skips formulas.

How can I export LaTeX from Confluence to Word, not just PDF?

Exporting LaTeX from Confluence Cloud to Word is available with the Scroll Word Exporter app by K15t, combined with LaTeX Math for Confluence.

Will switching LaTeX apps break my existing formulas?

If you use a LaTeX app with automated migration (like LaTeX Math for Confluence), equations transfer without manual rework. Without an automated migration tool, you’d need to rewrite each formula in the new app’s macro — manageable for 10 pages, painful for 100+.

<p>The post How to Export LaTeX to PDF in Confluence (Without Broken Formulas) first appeared on Stiltsoft.</p>

]]>