youngmon/atlassian-qna huggingface dataset:
Search should highlight why a page is included in the results
Asked by Rahav:

When searching the results shown should include an excerpt that surrounds the texts that was searched. The texts itself, that part that caused the page to be included in the search results should be bolded. Including a relevancy score may also be helpful but not mandatory.

The second suggestion for improvement of the utility of Confluence search is that once one of the results was selected then page would be displayed, not at its top, but focused on the part of the page containing the text that was searched.

I also recommend that as long as the user is viewing that part of the page the text that was searched for would be somehow highlighted to denote why the user was brought to that location. This would help the readers focus on what they were looking (searching) for.


Answers:
author: Nicolas Casel
body: Hi [@Rahav](/t5/user/viewprofilepage/user-id/1196512) ,

you can submit this kind of improvements to Atlassian via:

<https://jira.atlassian.com/browse/CONFSERVER-22326?filter=98691>

(set 'issue type' as 'suggestion')


Tags: cloud

confluence-cloud

search
Cursor (lack of) focus
Asked by Rahav:

The new Confluence is a great achievement, it is much better than what is used to be. But there is one point that was and is lacking and it goes to the core of Confluence, becoming an immersive experience for authors or not. Right now it is not.

Authors of content (that's what we use Confluence for, right) very often read a page before they edit it. For the authoring experience to become immersive Confluence must allow us to either click on the precise location on the page and start writing. It can be in the middle of a sentence, between characters, or before or after any paragraph. Our editing cursor must start at that precise location.

The editing button or KB shortcut must at list keep the place of viewing, although above method of direct clicking is much preferable. The problem is that these at this time always take us, the authors, our of focus when it jumps to the top of the page.

The problem is that right now


Answers:
author: Rahav
body: Most documentation tools allow you to simply click (with the mouse) exactly where you want editing to start.

No edit button is needed. Mouse click and start typing.

If Atlassian enabled that natural mouse click there would be no need for a workaround.


author: Miguel Jesus _Team Files_
body: I feel your pain. In particular when I just want to adjust some words in the middle of the page. However I'm a bit clueless on how to workaround this.


Tags: cloud

confluence-cloud
Confluence Backups XML File Size Issues
Asked by Aditya Kale:

Dear Atlassian Community,

Today we have a encountered strange issue after 7+ hours of XML backups a zip file generated with size of 5.7 MB only is there any way to track the file size real-time and rather sit and wait for it to pop up on the server? I saw it gets generated in /temp or /backups only when the backup is finished completely.

Our DB Size = 5GB and expected XML zipped size is 600 MB without attachments which was tested in non production but no luck in production instance it was aws ami copied over to non prod during testing.

I do see some issues with plugins/add ons WARN or ERRORS but that hardly made any difference previously. I was tracking this backup using XMLdatabinder DEBUG mode under atlassian logs and everything looked like it was working as expected

Any suggestions will be highly appreciated its very long exhaustive and error prone process that we have to unfortunately perform to switch our database and perform upgrade

Awaiting response


Answers:
author: Anurag Jalan
body: Also do check if enough disk space available on your server where confluence is hosted

comments: author: Aditya Kale
body: Thanks! :)


author: Anurag Jalan
body: Hi Aditya,

When backup is initiated in Confluence (either on adhoc basis or as scheduled job), it creates a temporary folder inside temp directory of confluence home_directory.

Now backup data starts accumulating there. Once complete backup finishes, confluence zip that folder. It keeps this zip file (under both temp \& also copy it to backup directories). After that, it deletes the original temporary folder which it had created earlier under temp.

So during this entire process, you can keep an eye on this folder whose size will increase with every passing minute which will give you an idea on size


Tags: backup

xml
Blank Page domain.com/index.action
Asked by Sophen Aik:

I recently enable Okta SSO on our Confluence Server. The SSO login part works but it goes to our domain.com/index.action and displays a blank page. Currently running version 7.2.0. What I've read so far that this might be related to not enough memory on the heap on the setevn.sh/seten.bat file. I'm not sure how to increase the memory.


Answers:
author: Richard Duffy
body: Hi,

You increase the memory in setenv.sh file which is located `<installation-directory>/bin/setenv.sh` file.

You will see params like this:

CATALINA_OPTS="-Xms4096m -Xmx4096m -XX:+UseG1GC ${CATALINA_OPTS}"
Add message when updating page via API
Asked by jc:

Hi there,

I am updating a confluence page using the API (Confluence module for Python) and I'd like to add a message for that version of the page Do you know if it's possible? I cannot see anything in the documentation...

Python I am using currently:

confluence.update_page(page_id=pageID(), title=page, body=body, type='page', representation='storage', minor_edit=False)

Many thanks in advance


Answers:
author: DPKJ
body: [@jc](/t5/user/viewprofilepage/user-id/3966155) Welcome to the community!

I don't see any obvious solution here, but you can always use comment feature.

```
confluence.add_comment(page_id, text)
```

comments: author: jc
body: [@DPKJ](/t5/user/viewprofilepage/user-id/690016) - thanks for the tip. Just tested that and it works nicely! This may be what I have to resort to. This script checks user changes to the page and reverts them if they fail validation. The message needs the context of the specific version to make sense. I suppose I could include the page version in the comment but it's not ideal.


Tags: confluence-server

server
How to add multi user picker form in my plugin settings view?
Asked by Vassil Petkov:

Hi all, I am trying to create some settings view for my plugin, where admin (or someone else) to be able to give access to user/group/role to use the plugin, but i can't find out how to add a multi user picker to my webwork? Can I use the jira customfield types, or i should create own, and if i can how to achieve it?


Answers:
author: smhf97
body: Hi Vassil,

Did you find a way to add a multi-user-picker to a custom plugin view?

comments: author: Vassil Petkov
body: Hi smhf97,

yes, it's not the one i hoped to be, but works as designed and expected.

We've created it using atlaskit and ReactJS.

Here's the [documentation.](https://atlaskit.atlassian.com/packages/elements/user-picker)

and also you can use Jira Cloud REST API user picker for auto suggestions.

Here's the [documentation.](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-group-and-user-picker/#api-group-group-and-user-picker)

Of course there is option to create your own using only the REST API.

Hope this one will help you.

My best


author: smhf97
body: Oh thank you for your quick response!  
Regards.


Tags: jira-core

jira-software
Functionality specifically for v 6.15.9
Asked by Cathy Siler:

Hi, I am new to confluence and am trying to self teach myself basic page set up functionality including options to integrate/embed JIRA boards. My company is using v. 6.15.9. My problem is that when I search for information, I get information for the newest version usually in the Cloud. Many times the information doesn't apply to my version. I can't figure out how to easily "weed" out information for the cloud version of Confluence or version higher than 6.15.9. Can anyone help me?


Answers:
author: Nic Brough -Adaptavist-
body: To answer the bit about generalised documentation, the Atlassian docs are mostly quite good at this.

Take for example <https://support.atlassian.com/confluence-cloud/docs/insert-the-jira-issues-macro/> - that is, as you say the "latest" doc on the subject and it's for Cloud.

Look to the top right of the body though. You'll see "cloud" highlighted in blue, with "Server \\/" next to it in grey. Click on the \\/ and you'll see a list of Server versions to select from.

Clicking on those will either take you to the same page, but written for your server version, or it will land you on a search when there's no direct link. The search is not brilliiant, but it will give you a decent list of candidates. Often it returns a good link for the latest version of Confluence, but going there and selecting the right version at the top right solves it.


author: Mike Rathwell
body: Hi [@Cathy Siler](/t5/user/viewprofilepage/user-id/3965851) and welcome to the Confluence world. You are at a bit of a tough spot as the *first* uses of Confluence will cause a bit of consternation as you are seeing here. So... I'll see if I can help you get going.

When I hear of someone wanting to embed something from another source in Confluence, it is true that is often the only way. *However*, that is usually a mindset from SharePoint or a copy/paste to a document. While you can do that, there are other and prettier ways to do it where the content in Confluence (I do this for reporting at my shop) is merely pulled in from Jira and then Confluence is formatting it.

You can start with working with the [Jira Issues Macro](https://confluence.atlassian.com/conf615/jira-issues-macro-967337948.html) and go from there. That macro can then be embedded in several other macros such as [Advanced Tables for Confluence](https://marketplace.atlassian.com/apps/197/advanced-tables-for-confluence?hosting=cloud&tab=overview) or [Table Filter and Charts for Confluence](https://marketplace.atlassian.com/apps/27447/table-filter-and-charts-for-confluence?hosting=cloud&tab=overview). These are a couple of things I do going beyond what the generic Jira Issues Macro can do.

A note; when you go to the link for the Jira Issues Macro, you'll note in the upper right, you can select cloud or a server version to get the pages for the version you live on. That said, the Jira Issues Macro has been pretty much static in... forever.

I hope this helps


Tags: confluence-server

server
In Confluence what is the difference between uploading a file and attaching it?
Asked by Chara_Hall:

I would like to know the advantages and disadvantages of each.


Answers:
author: repi
body: [@Chara_Hall](/t5/user/viewprofilepage/user-id/95564)

A file is uploaded and is then an attachment on the corresponding page. There and on every other page you can display it via macro


Tags: new-to-confluence
Generate a chart from a table on the same page but outside the macro's body
Asked by Anis_Malik:

Is it possible to generate a table using the built-in chart macro where the table is placed outside the chart macro's body.

Basically what I am trying to do is to have the table rendered as well but have it surrounded with the {expand} macro so that whoever needs to see the actual data can see it as well. But if I surround it with the {expand} macro within the chart macro body, the chart macro doesn't pick up the data.

The only way i think it would be possible to achieve this is to have a duplicate table surrounded with the {expand} macro and not have the chart macro render the embedded data table as well.

Please no marketplace solutions... sorry.


Answers:
author: Anis_Malik
body: After research... I have come to the conclusion that this is not possible with the built-in tools.


author: Katerina Kovriga {Stiltsoft}
body: It seems that you are right and there are no any standard solutions to generate a built-in chart with a table outside its body. Besides the standard Chart macro works only with plain and simple tables.

I see that you asked not to recommend any marketplace solutions but I have to explain one difficulty that you may have while using the duplicate tables.

You should always remember that you have two tables (not one!) and make changes to both of them to keep your information up-to-date.

As a representative of the StiltSoft team, I can say that for such purpose we use our own app - [Table Filter and Charts for Confluence](https://marketplace.atlassian.com/apps/27447/table-filter-and-charts-for-confluence?hosting=cloud&tab=overview). The [Table Excerpt and Table Excerpt Include](https://docs.stiltsoft.com/display/public/TFAC/How+to+use+Table+Excerpt+and+Table+Excerpt+Include+macros) macros allow us to show and update the only one source table and build multiple different charts based on this table.


Tags: confluence-server

server
Search - Multiple Labels - Document control/review
Asked by Richard Moore:

Hello,

I'm trying to use Confluence Labels to build up a company standard for document review dates, and I'm open for suggestion of how to better do this in Confluence. The current proposal is that any documents that require future review get two labels, department and review-yyyy-mm.

Therefore the department who own the document can search for their name and hopefully the review date to see if there are any documents that need review.

However the label search box seems to be OR and I couldn't find a way to make it AND.

Any method to make the search box an AND or better suggestions on how to use Confluence for policy/procedure document control and allow internal audits/follow up.


Answers:
author: Kris G _Alacriz_
body: You can use Content by Label macro.

On the first search criteria, give the document specific label.

You then 'Add a filter' and add the date label, whatever format it is in. This second filter acts as AND with the first filter.

Once you're done with the review, remove the date label or rename it.

I hope that helps.

Thanks,  
Kris

comments: author: Richard Moore
body: Brilliant thanks Kris.

That or the Label List get me what I wanted. Thanks again.

Thanks Kris. That and the Label List Macro are two good options and get me what I need.


Tags: cloud
Can I embed smartsheets into Confluence?
Asked by steph ventura:

I tried to follow steps on [this page](https://confluence.atlassian.com/confkb/how-to-embed-smartsheets-in-confluence-using-the-html-macro-800862394.html?_ga=2.57703842.905245935.1591880822-1226081069.1591286558#) but apparently it only applies to the Confluence server?

So if I'm not working on the server but just a regular Confluence subscription, is it even possible to do this?

Thanks!


Answers:
author: Nar Kumar C. - Narva Software
body: Hi Steph,

HTML Macro is not available for Confluence Cloud. You can use our add-on from Marketplace: [HTML Macro for Confluence](https://marketplace.atlassian.com/apps/1221472/html-macro-for-confluence?hosting=cloud&tab=overview)

You will have to publish Smartsheet in order to embed, refer to [documentation here](https://help.smartsheet.com/articles/522078-publishing-smartsheet-items). **You should make it read only as you will be sharing with all Confluence users**. Publishing it will give unique url and embed code which you can use in Confluence.

Let us know if you face any issue.


author: Joshua Sneed Contegix
body: Hi Steph,

The HTML macro isn't available for Confluence Cloud and you will need something like the [HTMK Macro for Confuence Cloud](https://marketplace.atlassian.com/apps/1212279/html-macro-for-confluence-cloud?hosting=cloud&tab=overview) plugin. Cheers!


Tags: cloud
I can't do what confluence is telling me to do.
Asked by steph ventura:

I was following the steps below but I do not see Confluence HTML Macros where it says it should be.

Enabling the HTML Macro {#toc-hId--1330455728}
----------------------------------------------

1. Go to ![](https://confluence.atlassian.com/doc/files/747833194/747833195/2/1517274813281/cog.png) \> **Manage apps**.

2. Select **System** from the drop down and search for the **Confluence HTML Macros**system app.
3. Expand the listing and enable the **html (html-xhtml)** module.

Does anyone else know how I can enable this if I can't find what I'm supposed to look for?


Answers:
author: Sven Schatter _Lively Apps_
body: Hi [@steph ventura](/t5/user/viewprofilepage/user-id/3693561),

I suppose you got this text from [this page](https://confluence.atlassian.com/doc/html-macro-38273085.html)? This is actually for Confluence Server. For Confluence Cloud there is no native HTML macro available.

If you still need a HTML macro in the Cloud, you should [have a look at the Marketplace](https://marketplace.atlassian.com/search?hosting=cloud&product=confluence&query=html). There are several solutions available, but keep in mind that they are not as powerful as the Server HTML macro. This is because in the Cloud Atlassian sandboxes apps inside iframes. This means you can't for example style your page using a HTML macro, or execute arbitrary JavaScript that interacts with the rest of the page like you can on Server.

Hope this helps! Bonus tip: look in the top right Corner to see whether documentation corresponds to Server or Cloud. :)

![temp.png](https://community.atlassian.com/t5/image/serverpage/image-id/98755iB05EADD8F20E7474/image-dimensions/494x302?v=v2 "temp.png")

Cheers,  
Sven


author: Matt Reiner [K15t]
body: [@steph ventura](/t5/user/viewprofilepage/user-id/3693561)

What are you looking to do with custom HTML?

comments: author: steph ventura
body: I thought I had to do that to embed smartsheets into Confluence (the cloud, not the server). But if you know how to embed smartsheets, that would be helpful!


author: Matt Reiner [K15t]
body: Ahhhh, sorry. I've never done it personally, but maybe this app will help: [https://marketplace.atlassian.com/apps/1212279/html-macro-for-confluence-cloud?hosting=cloud\&tab=overview\&_ga=2.146174199.297835342.1592218656-1126997211.1540405048](https://marketplace.atlassian.com/apps/1212279/html-macro-for-confluence-cloud?hosting=cloud&tab=overview&_ga=2.146174199.297835342.1592218656-1126997211.1540405048)


Tags: cloud
Customize CSS in the cloud version
Asked by Rodrigo Batista Edamatsu:

Would I like to know if there is any way to **customize css** in the **cloud version** ?  

Thanks!


Answers:
author: Nic Brough -Adaptavist-
body: No, it's disabled on Cloud.

comments: author: Rodrigo Batista Edamatsu
body: Is there a recommended plugin to customize the theme?


author: Shannon S
body: Hello [@Rodrigo Batista Edamatsu](/t5/user/viewprofilepage/user-id/3965317)

Welcome to Atlassian Community! You can find more information about themes in Confluence Cloud from our site:

* [Install a Theme](https://support.atlassian.com/confluence-cloud/docs/install-a-theme/#:~:text=Once%20you've%20installed%20a,site%20or%20to%20individual%20spaces.&text=in%20the%20Confluence%20navigation%20%3E%20Themes,default%20to%20the%20new%20space.)

In that article, we recommend that you use one of the theming apps that is available on Marketplace for Confluence Cloud:

* [Confluence Cloud Theming Add-ons](https://marketplace.atlassian.com/search?category=Themes%20%26%20styles&hosting=cloud&product=confluence)

Let us know if you have any questions about that!

Take care,

Shannon


author: Terri Isidro
body: Just curious if the reasoning for disabling this is the security flaw of using PDF stylesheet? If so, what was the likelihood for this security flaw being exploited?  

At the very least it would be extremely helpful in Confluence to allow addition of custom colors, availability of more fonts for headings to better replicate branding without paying for outside apps.  

Will look into theming, but this has taken forever to unpack, and if theming is the answer to customizing Confluence for branding, elaboration/simplification of this information in user docs would be so helpful. Thanks!


author: Annelotte
body: Hi,

There is a feature request open for this (has been for years apparently)  
You can vote for it, you never know they will finally listen!

<br />

**<https://jira.atlassian.com/browse/CONFCLOUD-36137>**


Tags: cloud
Is it possible to create a chart in page by referring to table from another page?
Asked by Kedar:

I have a requirement to show some report about work, so today I need to create a table every week. but going further I want to have the table in a common location where the team can update the information

and I as manager can generate report from table in another page, where reporting is done.


Answers:
author: Katerina Rudkovskaya [Stiltsoft]
body: Hi Kedar,  

You can do it with the help of [Table Excerpt (Include)](https://docs.stiltsoft.com/display/public/TFAC/How+to+use+Table+Excerpt+and+Table+Excerpt+Include+macros) and [Chart from Table](https://docs.stiltsoft.com/display/public/TFAC/How+to+use+Chart+from+Table+macro) macros of the [Table Filter and Charts for Confluence](https://marketplace.atlassian.com/apps/27447/table-filter-and-charts-for-confluence?hosting=cloud&tab=overview) app.  

1.Wrap your source table (in a common location) with Table Excerpt.  

![Screenshot_1.png](https://community.atlassian.com/t5/image/serverpage/image-id/98756i4970A550087EE069/image-size/large?v=v2&px=999 "Screenshot_1.png")  

2.Insert Table Excerpt Include on the page for reporting.  

3.Wrap it with Chart from Table and configure its parameters.  

![Screenshot_2.png](https://community.atlassian.com/t5/image/serverpage/image-id/98757i62C1E0313A50E3A0/image-size/large?v=v2&px=999 "Screenshot_2.png")  

<br />

<br />

Thus, you build the dynamic chart based on the table, which is sometimes updated by your colleagues.  

Katerina  
StiltSoft


Tags: confluence-server

server
How can we create a separated Index at same page?
Asked by Liara Salerno Valle:

Does anybody know if it would be possible to create two different Index? one at a collum and a separated one with different topics at the other side?


Answers:
author: Shannon S
body: Hello Liara,

Thank you for bringing this up to us! Happy to help you.

Confluence Cloud includes a Page Index Macro, but I don't believe this is what you are referring to. Take a look at the [Page Index Macro](https://support.atlassian.com/confluence-cloud/docs/insert-the-page-index-macro/) documentation to see what that looks like. Is this perhaps the column layout you're referring to?

The other option you mention, which organizes pages by topics, would need you to use labels in order to do this. I would recommend having a read through [Use labels to organize your content](https://support.atlassian.com/confluence-cloud/docs/use-labels-to-organize-your-content/). There are various macros listed on that page that you can use in order to display content depending on the label (in this case, topic), that you choose.

If this information doesn't help you to get the results you need, would you be able to show me an example of what you're trying to do exactly?

Looking forward to hearing back from you!

Take care,

Shannon


Tags: cloud