Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

Issues with a resolution in confluence page

Patryk Kogut
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
May 26, 2025

We're building a Confluence space to centralize and share knowledge across multiple teams. However, we've encountered an issue with how content is being presented. Many team members are using tables to structure information and instructions. This approach is causing layout and readability problems—particularly on smaller screens or mobile devices—since tables don't respond well to different screen sizes.

We're looking for best practices or recommended layout strategies to present standard work instructions in a clean, responsive, and user-friendly way. What approaches have you successfully used to create well-structured, scalable content without relying on tables for layout?

3 answers

1 vote
Janine Jochum-Frenster_Aura Apps_
Atlassian Partner
May 26, 2025

Hi @Patryk Kogut 

Nice to meet you and welcome to the community.  

There are a couple of Marketplace apps that help with exactly this – including some from Aura Apps. Even though I happen to work for Aura Apps myself, I also use our apps regularly, as they make my work with Confluence much easier.

With Aura content formatting macros, you can add individual elements such as panels, dividers or tabs to your Confluence pages to help provide more structure and clarity.

Confluence-expand-macro.gif

The Karma Page Builder offers you a direct solution for designing an entire Confluence page with a range of templates and many customization options.

Karma.png

You can download both apps free of charge for testing from the Atlassian Market Place in your Confluence instance via the links.

If you have any further questions or feedback, please do not hesitate to contact me.

 

Best regards Janine

Kate C_
Community Manager
Community Managers are Atlassian Team members who specifically run and moderate Atlassian communities. Feel free to say hello!
May 26, 2025

Hey @Janine Jochum-Frenster_Aura Apps_

It looks like you're part of a Marketplace App team, please follow the steps outlined  here  to get an 'Atlassian Partner' lozenge for your profile! If you run into any issues, please reach out to us at communitymanagers@atlassian.com. Cheers!

Janine Jochum-Frenster_Aura Apps_
Atlassian Partner
May 27, 2025

Hey @Kate C_ thanks for the reminder. In this moment I am working on adding the lozenge to my profil. 

Like Kate C_ likes this
Kate C_
Community Manager
Community Managers are Atlassian Team members who specifically run and moderate Atlassian communities. Feel free to say hello!
May 27, 2025

Wonderful! If you need any help, let me know!

0 votes
Zoriana Bogutska_Adaptavist_
Atlassian Partner
May 28, 2025

Hi @Patryk Kogut 

Welcome to the community :) 

 

Do you want to view things through app? There are problems with showing Confluence formatting elements on mobile apps, it doesn't show everything and macros.

If you plan view pages through web view and need better structure, look and feel of your page, you can take a look to app like Mosaic. It offers key formatting features (tabs, cards, numbered headings, advanced expand, banners, etc.) that help to organise your content

To show how it can make your pages look like I've added screenshots of its templates. 

 Screenshot 2025-01-22 at 09.08.15.pngScreenshot 2025-03-13 at 07.03.26.png

If you have any questions or need help please let me know, my team developed Mosaic :) 

0 votes
Kristian Klima
Community Champion
May 26, 2025

Hi @Patryk Kogut and welcome to the Community.

In general, tables are notoriously hard to display so I try to keep them at minum and only when they're necessary = displaying relationship / definitions among multiple categories of enttities.

I don't use tables when

  • there are only two columns
    this is how I do it = basically, a bullet point with the term, then definition follows using a soft return

    • Or you can do another ident for the definition and/or other elements
  • avoid using lists, let along ordered lists for procedures in the table
    I know this is tempting but such tables are inherently detrimental to the readers ability to navigate and understand. I've seen truely attrocious tables with multiple cells featuring complex procedures, notes. 

    In other words, the advantage to show relationships between so many elements in one place evaporates over the sheer complextity of the content crammed into cells.

    I learned that there is always a way to organize your information differently.

Having said that, if you have to sort 10 elements vertically and 15 elements horizontaly with simple cell content, go for a table. You may look into 'theme' apps that can render tables better (example). 

But there always be a situation where the table's physical size meets the limits set by the screens's pixels.

Suggest an answer

Log in or Sign up to answer
TAGS
AUG Leaders

Atlassian Community Events