youngmon/atlassian-qna huggingface dataset:
Insert Macro into an existing Confluence Page without knowing the new macro id
Asked by Samer Sboui:

Hi atlassian connect play java developers, i would to update a page body with a new macro without knowing the new macro id !! any help plz and thnx.


Answers:
author: AnnWorley
body: Hi Samer,

If you can find a page where the macro is already present, you may view the macro ID via the View Storage Format menu:

![Screen Shot 2018-08-14 at 12.33.36 PM.png](https://community.atlassian.com/t5/image/serverpage/image-id/29446i9D80C30B2104090D/image-size/large?v=v2&px=999 "Screen Shot 2018-08-14 at 12.33.36 PM.png")

For more, better tips on Atlassian Connect, please try our [Developer Community](https://community.developer.atlassian.com/) as well.

Thanks,

Ann

comments: author: Samer Sboui
body: thnx Ann, i have another problem in my addon !

When i tried to create a new blueprint in my space i got an error "we can't create content with this type of page" any help plz.


author: AnnWorley
body: There are some developers on this forum but the [Developer forum](https://community.developer.atlassian.com/) is a better bet.


author: Samer Sboui
body: ok thnx Ann


author: Tobias Anstett _K15t_
body: Hi,

You do not need to provide a ac:macro-id when inserting a new macro. Confluence will take care of it anyway.

If you still want to provide a macro-id you just have to make sure that it is unique for the page (not for the system). Thus you could generate whatever id using the same pattern as in your Atlassian example.

Best,  
Tobias


Tags: confluence-cloud

connect

developer
Add button to create a new table row
Asked by Maithily Kohale:

I have a table on the confluence page.

I want to Add a button to the page, which functions to create a new top row in the table, and opens the page in the edit mode so the the users can enter data in the new row.

Can this be done?


Answers:
author: AnnWorley
body: There is no macro built into Confluence that provides a button to put a page into edit mode and add a row to a table. It sounds like something that might be achieved with a user macro, though I don't have an example. Here is the User Macro documentation: [Writing User Macros](https://confluence.atlassian.com/doc/writing-user-macros-4485.html)

comments: author: Emily Errico
body: Note that user macros are only an option for server instances, not cloud.


author: AnnWorley
body: Good point.


author: Maithily Kohale
body: Thank you Ann and Emily for these responses.
Removing items on left side of confluence page related to navigation?
Asked by Andy:

Is there a way to remove the blog, and draw.io.diagrams on the left side of the space in confluence? My company wont do a blog and i am not sure what draw.io.digrams gives me when its on the home page of my space? I noticed that if i wanted to draw diagrams i can draw them on other pages under the home page anyways.


Answers:
author: Zak Laughton
body: Hi Andrew,

These links are customizable for each space. To remove them, go to **Space tools** (bottom of sidebar) \> **Configure sidebar** and click the "Hide Link" icon next to the link. (For more info, see [Configure the Sidebar](https://confluence.atlassian.com/doc/configure-the-sidebar-317194694.html)).

-Zak

comments: author: Andy
body: Hi Zak,

Wow, I totally missed that in my reading. I will have to be more careful next time. Many thanks for the reply.

Andrew


author: NkMk
body: Mmmm, this nearly works. I can remove the Blog and Overview pages but there's not an option to remove Draw.io from the left nav
How to edit a confluence page without WYSWYG mode?
Asked by Lawrence:

When I edit and existing conflluence page, the browser also bring up the GUI editor. How can I edit a confluence page in a text file?

Thank you,

Lawrence


Answers:
author: Nic Brough -Adaptavist-
body: You don't. Confluence is a rich editor.

In theory, you could edit it in a text editor, but you'd have to be someone who can read and write xhtml and be 100% accurate when doing so. I don't think I've ever edited any XML by hand and got it right first time.


Tags: editor

wysiwyg
The import word functionality in Confluence isn't working properly
Asked by Charitha Veeragandham:

I basically want to import a pdf document into a Confluence page. Since Confluence doesn't have that feature, I converted the pdf document into a word and then imported the word document into the Confluence page. But, the page doesn't display the format properly. The images are missing and the format is tampered. I tried doc, docx and rtf documents. Nothing seems to work.

The original word document:

![Capture.PNG](/t5/image/serverpage/image-id/28645iABEC91513753523B/image-dimensions/478x353?v=v2 "Capture.PNG")

Confluence Page:

![Capture1.PNG](/t5/image/serverpage/image-id/28646i227F849D959A0E46/image-dimensions/653x414?v=v2 "Capture1.PNG")


Answers:
author: Steven F Behnke
body: The import is a best effort process. It is not perfect and cannot perfect translate image-heavy PDF's.

Either recreate it or live with the sub-standard import.


Tags: import

ms-word
Changeable status macro
Asked by bibanator:

Hello.

Is there any way to rewrite special elements without page editing? Something that can be changed quickly and saved by one click like task checkbox -- \[\]. Like status, but changeable.

Thx for attention.


Answers:
author: Max Foerster - K15t
body: Hi Bibanator,

I was recently looking for something similar for a customer and came across an app on the marketplace called "[Easy Dropdown Menu (Drop down selection)](https://marketplace.atlassian.com/apps/1216797/easy-dropdown-menu-drop-down-selection?hosting=server&tab=overview)". They even offer a live example page to try it out. Not sure if that's what your looking for speaking about "special elements". But maybe have a look! :)

Best, Max


author: Andrey Khaneev _StiltSoft_
body: Hello,

Yes, there is a [Handy Status](https://docs.stiltsoft.com/display/HMFC/How+to+use+Handy+Status+macro) macro in the [Handy Macros](https://marketplace.atlassian.com/apps/1214971/handy-macros-for-confluence?hosting=server&tab=overview) add-on. You can try it on the [demo site](https://demo.stiltsoft.com/display/HM/Handy+Status?os_username=guest1&os_password=guest1&pagepropertiesreport.serverrender).

comments: author: bibanator
body: Thanks!

This is an idea.

But is there more compact way? Handy Macros is huge and I need only 1 of it's functions. It would be interesting to write my own small macro. I saw a huge dev documentation but didn't find the 'saving-without-editing' method. Does it even exist?

Please can you hint me right direction?


author: bibanator
body: ty best community ever

comments: author: bibanator
body: I'm so disappointed. I'm leaving heartless Atlassian machine


Tags: confluence-server

macro

server

status-macro
Numbered Lists - Continuing one or restarting one at a chosen number
Asked by Kimberly Giere:

I have read two discussions on this issue but they are a few years old. So I thought I'd bring it up again to see if there were any new solutions found to the problem.

We do a lot of documentation; step-by-step instructions with images, tables, etc. We also frequently use two column layouts. I've figured out the Shift+Enter to insert a blank line for an image and then Enter to continue the numbered list. That is a big help. ***However***, what I still need is an easy way for a beginner, tech writer type person who does not know macros and html, to start a list at number say 4. For example, in a two column layout:

1. step one 4. step four

2. step two image

image 5. step five

3. step 3

Has anyone come up with a straight-forward way to do this that does not involve having a software engineering degree?

Thank you!


Answers:
author: AnnWorley
body: Hi Kimberly,

I haven't found an elegant way to continue numbered lists in columns or after inserting other content. I found that we have a request open to add that functionality to the editor - please vote or comment to emphasize your use case to the development team:

Cloud: [Allow the number list to continue in case a different format is inserted between the number list](https://jira.atlassian.com/browse/CONFCLOUD-7794)

Server: [Allow the number list to continue in case a different format is inserted between the number list](https://jira.atlassian.com/browse/CONFSERVER-7794)

Thanks,

Ann

comments: author: Kimberly Giere
body: Hello again Ann. Thank you for adding this functionality. We do all of our documentation on Confluence and need to use various layouts to present the information in the most usable way. Examples are two column layout, collapsible sections (often with multiple columns in a section), and inserted tables. The ability to control numbering would be a huge help to us. Currently, we do not use the automated numbering feature on complicated layouts; we have to number manually. Manual numbering is fine, but it does introduce a risk of formatting error when edits are done as well as being labor-intensive when an entire long article needs to be manually re-numbered from the point of change forward.


Tags: column

layout

numbered-list
What are the default available color named text tags in Confluence?
Asked by Tini Good:

The documentation references the Wikipedia page with 16 HTML color names. The built-in Confluence text color picker GUI has 40 colors (8 columns by 5 rows). When using the Panel macro, et al., I'd like my border and/or background color to match various of these 40 color options using their name, rather than having to keep track of the Hex code (I can memorize 40 names more easily).

Initially I thought the full answer was that only these 16 HTML colors can be chosen *by named text tag* in Confluence macros, even though 40 text colors are offered through the GUI. However, Darkgray works in the Panel macro and testing confirms that option differs from the color returned by color text tag Silver or Gray. Using a colorpicker confirms the Confluence text color matches the hexcode for these three X11 named colors as well.

So some of the available names can be determined by colorpicker RGB or Hex code and referring to the X11 colors on the same Wiki page. Others I have not been able to find.

The current documentation is incomplete for colors, does anyone have this list?

P.S.

As an interesting aside, while testing, I played around in JIRA, and it seems to support more named X11 colors than Confluence. These text color tags were not rejected in JIRA, but they did not all work in Confluence.

```
{color:lightgray}text{color} {color:silver}text{color} {color:darkgray}text{color} {color:gray}text{color} {color:dimgray}text{color} {color:LightSlateGray}text{color} {color:SlateGray}text{color} {color:darkSlateGray}text{color} {color:black}text{color} {color:cornflowerblue}TEXT{color}
```


Answers:
author: Tini Good
body: OK, so the 40 text color tag options available via the GUI are the Excel color palette.

The named color list you can use in macros (such as Panel) appears to be the 140 named colors of CSS/HTML4. It does not recognize all the X11 color names.

These two overlap, but the Excel 40 is not a subset of the CSS 140.

This took me a ridiculously long time to figure out. Enjoy!


author: Tini Good
body: Argh! They are the Standard 40 Excel color palette! Perhaps because you need to be able to export to Word?

However, the color names for this palette on most of the websites don't all seem to work, particularly some of the two word color names.

Soo close....


Tags: confluence-server

server
Labelling a task in Confluence
Asked by Charlie Smith:

Is there a way to categorise or label a task list within a page on Confluence?

I'd ideally like to label a list as 'Co-Owned' and then users can search that label and see any tasks that are labelled 'Co-Owned'.


Answers:
author: Jonathan Smith
body: Hi [@Charlie Smith](/t5/user/viewprofilepage/user-id/1470392),

Currently we can only use the date and mention funcitonality for a task.

There was some community feedback on this question noted here: as well <https://community.atlassian.com/t5/Confluence-questions/Is-it-possible-to-categorize-or-label-tasks/qaq-p/3088>

**Work around**: In a few of our spaces, we implemented the use of tables with tasks. The task itself would appear in column A, column B would hold multiple assignees, and column C was our status or label.

* We also wrapped this table with the table filter macro (paid add-on) so we could filter the various columns.

The groups then managed the tasks from that page versus using the "task report macro".

Hope this helps!

comments: author: Charlie Smith
body: Thank you so much for your workaround Jonathan, that might actually work for us.

I appreciate you taking the time to answer my query :)


Tags: confluence-server

label

list

server

task

tasklist
Have you used Confluence as customer facing/access knowledgebase?
Asked by Jennifer Vecellio:

Looking for a customer facing/access knowledgebase for large body of content. Being able to search is key. Wondering who has used Confluence for this and any setup tips/best practices. Looking for good/not so good feedback. Thank you!


Answers:
author: Philip Colmer
body: We're using Confluence as a knowledgebase and we've had a few reports of users not being able to find what they are looking for. The problem seems to be stemming from two issues:

1. Users are used to Google, so they expect Confluence to just "understand" what they are searching for.

2. Related, users don't necessarily use the same words or terms as documentation writers, so search fails there.

I don't know if there is a solution to either of those points but that is our experience.

The platform is, I think, pretty good for holding the knowledge ... but structure and content isn't enough. If a user can't figure out the structure because they don't know enough to figure out where to look for the answer, they are going to resort to search and if search lets them down ...


author: Jennifer Vecellio
body: I've found a lot of comments regarding using Confluence internally, but can't find info on using it for an external facing solution. Thanks!


author: Jennifer Vecellio
body: What type of feedback do you hear from your customers who are using it?


author: Davin Studer
body: Confluence is a great platform for this. However, the tool alone will not make you documentation great. We have teams in our organization that do a great job with the content and they like confluence. We also have other teams that have not been organized and methodical in the approach and they are the ones that complain about the products that is is impossible to find what they want.

So, whatever tool you use make sure to have a plan to keep you content organized and make sure that you have buy-in and understanding from all those that edit the content so that you have consistency.


Tags: customer

knowledge-base

search
notification email
Asked by Abdu Kibuuka:

Hi,

Each time I add to my knowledge base, it sends out an email. How can I change that email ?.

Thanks,


Answers:
author: Zak Laughton
body: Hi Abdu,

There is not a way to change the email within Confluence, but you can modify the email templates in the source code. However, this type of modification is not supported, so be sure to make any necessary back-ups and test in a non-production environment first.

To learn how to modify the emails, see [Customizing Email Templates](https://confluence.atlassian.com/doc/customizing-email-templates-168001822.html).

-Zak
Reading the JAVA_HOME environment variable from a Windows 2016 Server service?
Asked by Mark Flint:

Is there a way to configure Atlassian products which are installed as a Windows 2016 service, so it reads the JAVA_HOME variable? Right now the installer is creating a registry entry where one of the Java properties in the registry is "Jvm" and points to whatever JAVA_HOME was set to at the time of the service creation.

Could it be as simple as deleting the "Jvm" registry entry that the Tomcat installer put there?

The reason I ask is our security team insists that we upgrade to the latest version of java shortly after it is released, so we change our version of java about once a month. If possible I am hoping not to have to uninstall the services and reinstall, or edit the Windows registry.


Answers:
author: Igor M.
body: Hello,

By default, Confluence is installed with its own JRE and will read variables from there, however, you can install and use your own JDK and get Confluence pointing to new JAVA_HOME by following [Setting the JAVA_HOME Variable in Windows](https://confluence.atlassian.com/doc/setting-the-java_home-variable-in-windows-8895.html) guide.

Regards,

Igor


Tags: bamboo

bitbucket-server

confluence-server

fisheye-crucible

jira-server

server
Can we authenticate to Confuence with our existing Id server through Oauth or SAML?
Asked by Andrew Crowe:

Hi,

We are looking at using Confluence, but it must be able to authenticate using our current identities. We are using WSO2 ID server, so its standards based and can accept Oauth2, SAML, OpenId, OpenID connect.

So the question is, can we authenticate to confluence with our current identities through one of these protocols?

Many thanks

Andy.


Answers:
author: Christian Reichert (resolution)
body: Hi Andy,

from the Tags you have chosen, it looks like you are going to use the Cloud Version of Confluence.

You'll have to look at "Atlassian Access", which is the identity management solution from Atlassian for their cloud products. Atlassian Access can connect to other systems via SAML (however in the paid version only - roughly 3 USD per User/month).

<https://www.atlassian.com/enterprise/cloud/access>

<br />

Cheers,  
Christian

comments: author: Andrew Crowe
body: Hi Christian,

Thats great thanks. Thanks for the information. So it can do it, its just extra cost!

Thanks again,

Andy.


Tags: cloud

confluence-cloud
During a Word import - how can I map Word-styles to Confluence-styles?
Asked by Robert E_ Schneider:

We want to turn our manuals into confluence pages. We use the "Import Word document" function for this and have the document split at level 1.  

The Word documents are long (some have 600 pages and more) and they use a plethora of Word-styles.

I found that the word style "Header 1" (in German: "?berschrift 1") will automatically cause the system to create a fresh sub-page, when its hit. And in my import I can see that "Header 2" ("?berschrift 2") is automtically converted to Confluence's "Header 1".

During a former upload I didn't have "?berschrift 1" in my document but a completely different name. With this different name the import program was unable to find where to split my document and I ended up with on very long Confluence-page.  

Question 1: how do I know, which Word-stlyes are recognized by the import function and to which Confluence-styles they are mapped?  

Then I have a situation where a Word-style is indented. When I look at the standard formatting options in Confluence that would be a combination of a regular "Paragraph" style plus indentation.   

Question 2: is there any way that I can make the import function reproduce this combination?  

Then threr are situations where the style is "Standard" but then someone manually added numbered list. So in Word you see: "Standard + Numbered List".  

Question 3: is there a way I can reproduce that during the import?  

And finally: it looks as if the import does not put a \<br\> line break wherever a Word paragraph was. So, if I have a numbered list in Word, right now it is converted to several lines:  

Word:  
1. Apples  
2. Pears  
3. Bananas  

Confluence import:  
Apples  
Pears  
Bananas  

If the import gave me a numbered list right from the start I'd be glad.  

But if I don't get that and want to re-format the lines manually I can mark the first line and tell the system to make that a numbered list by pressing the button in the menu. But for some reason Confluence does not "see" that the line ends after the Apples.  

So, when I mark the Apples-line and press the "numbered list" button, I get this:  

1. Apples  
Pears  
Bananas  

I can remedy this by first moving the cursor to the end of each line and pressing "Enter" and then "Delete". This way I add a "Confluence-style" paragraph end and I remove the one that was inserted by the import. Once I have done that for each line I can mark all of them, press the "Numbered List" button and I will get:  

1. Apples  
2. Pears  
3. Bananas  

It seems to me, as if the import function does not replace the Word-paragraph with Confluence's equivalent.  

Question 4: Is there anything that I can do about this?


Answers:
author: Robert E_ Schneider
body: Additional info: I noticed this when looking at the imported document in the source editor:  
The import function uses a \<br/\> wherever there is a paragraph-end in the Word-document.  

When I press enter, I produce a \</p\>  

Can I customize this somehow?


Tags: cloud

confluence-cloud
Confluence fails to start
Asked by Ikhoon Chon:

Hi,

I don't know exactly when this error began (we didn't use the confluence since April for some reasons), but I found that confluence fails to start.

I've checked and searched for the solution but could not find any clue.

I attached today's logs.

* <https://s3-eu-west-1.amazonaws.com/kicktest.net/atlassian-confluence.log>
* <https://s3-eu-west-1.amazonaws.com/kicktest.net/catalina.2018-08-03.log>

Could you please help?

Best regards,  
Ikhoon


Answers:
author: Moses Thomas
body: [@Ikhoon_Chon](/t5/user/viewprofilepage/user-id/1023067) Base on logs, i think is time to clear plugin cache

Please follow steps here <https://confluence.atlassian.com/confkb/how-to-clear-confluence-plugins-cache-297664846.html>

best!

comments: author: Ikhoon Chon
body: That resolved the problem. Thanks!


author: Moses Thomas
body: [@Ikhoon_Chon](/t5/user/viewprofilepage/user-id/1023067)You are welcome!, please mark solution as accepted/vote so others can use solution.

Best!


Tags: confluence-server

server
How to add figures at the display of chart macro results.
Asked by Jayakumar Narayanamoorthy:

How to add figures at the display of chart macro results.


Answers:
author: Zak Laughton
body: Hi Jayakumar,

I'm not sure exactly what you mean by this. With the base functionality, it's not possible to add images to the chart produced by the chart macro. But to be sure I'm understanding correctly, could you describe what figures you'd like to add and where you'd like to add them?

Thanks!  
-Zak

comments: author: Jayakumar Narayanamoorthy
body: ![bar.JPG](https://community.atlassian.com/t5/image/serverpage/image-id/28682i1781FCEFC7C233EC/image-size/large?v=v2&px=999 "bar.JPG")
How to filter a specific content from all child pages
Asked by tina raj:

Hi

I have multiple pages for a project. In each of the pages I have a table with a column Status that has data "Pending"

I want to display the items from all pages which is having the columns as "Pending"

How can it be done


Answers:
author: Andrey Khaneev _StiltSoft_
body: Hi Tina,

You can use [Page Properties Report](https://confluence.atlassian.com/doc/page-properties-report-macro-186089616.html) to collect this data in a single table. The filter this table by Status column with [Table Filter](https://marketplace.atlassian.com/apps/27447/table-filter-and-charts-for-confluence?hosting=cloud&tab=overview) macro. Here is a [video tutorial](https://www.youtube.com/watch?v=JGIijnaL9mU&list=PLRpx9wuFqlzGZOZCj2PkQI2T4Bhkg3cVl).


author: EPS Software Engineering AG
body: Hi Tina,

You also could use our Easy Dropdown Menu and use a CQL-Filter in your Page Properties Report Macro. Like that you find only pages with the Status set to "Pending". If the word Pending is used somewhere else on the page, it could be falsely found.

Regards,  
Stephan (CEO of EPS Software Engineering AG, the vendor of the Easy Dropdown Menu)