Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

The content by label macro not working

Recently the content by label macro seems to have stopped working. After some initial investigation, it is only the labels that have been added in the last 2 weeks or so that are affected. Any older label seems to work in this macro. Any ideas why new labels would not allow this macro to function correctly?

Thanks in advance for any help.

3 answers

1 accepted

0 votes
Answer accepted

Perhaps you need to index your content? This doesn't really happen but sometimes the index fails. If it happens multiple times you should open a support issue at

Thanks for the quick reply. I'll give this a shot.

This was actually what I was going to first answer with.  You'll know it's an indexing problem if you go to Administration > Content Indexing > Queue Contents and see a long list of things needing to be indexed.  This is supposed to be processed every 30 seconds (or at least nightly), but if you're queue is still growing, please follow this workaround:

You can force Confluence to create a new index file:


    Stop Confluence.

    Delete the following folders from the home directory if they exist (# rm -Rf <dir>):



    Start Confluence.

    Go to General Configuration page.

    Search for the Content Indexing option towards the bottom of the left side bar.

    Click on Rebuild.


The above steps will ensure that Confluence will create a new index file.



same problem here. 

try do re-index

it solved my problem 

That's not an acceptable solution - re-indexing can take hours on a large instance serving thousands of people, during which time Confluence can be unbearably slow.

If you add new Labels to the page only, you must also Edit said page, select the Content by Label macro (e.g. the default "Related Articles" macro), click Edit on that, and also add the new labels to that.  When you first create the page, all of your labels for the page are automatically added to this macro, however any edits to the labels need to be done in both places (inconvenient I know). Also, if you move that page, you may need to edit the macro and change/update the Space that it is looking in (I just noticed this myself)

Just some additional info - I've been creating series of pages around different types of content. So for example, I created a couple of pages around peer reviews and  use this macro to create a "related pages" section on each page. I've been doing to for several months and it stopped working about two weeks ago (and only with new labels). When I go back and edit the page to add the label to the macro, it allows me to add the label (even prefilling as I type), however, after I save it and then the page, I get a "There is no content with the specified labels" message. If I replace it with an older label is works just fine. Thanks

Exactly what's happening here.. 

I ran the Index rebuild and it seemed to work for a minute. That is, the How To page now picks up the pages I added most recently. But when I added a new one just to test it, I'm back to the same problem.

I don't know if it's at all related but my Queue Contents list is filling up without being processed. The screen says "By default, the contents of the queue are processed every minute." but there were 1152 an hour ago, and 1174 now, and we're a pretty small shop. The index rebuild didn't affect this at all.


@Maggie Secara please see the actual answer of solving that that I replied as a comment to the other answer.  It'll solve your problem


@Geoff Wilson But I'm not talking about adding a new label to a page that .already exists. This is a brand new page, with just the one label. As you said above, "When you first create the page, all of your labels for the page are automatically added to this macro." No, they are not. They were until abut 3 weeks ago, but not now. That's what's not working

Like this:

  1. Click Create... and select How-to Article
  2. Click Next
  3. Enter a Name and click Create.
  4. Add some content and click Save.

This new page should appear automatically on the How-to Articles page, right? It does not. All the older pages are listed, but no new ones.

When I run the Index Rebuild as @Steve Behnke [] suggested, the How-to Articles content report table refreshes and the new page now appears on the list. That is the only way to make it do what it's supposed to do. 

Fortunately our Index is young and the rebuild only takes a few seconds, but this could be a serious problem eventually.


Either look at the logs to try and find a root cause or just restart your application and hope that fixes it.

The problem still occurs in confluence 5.10.7.  We have reindexed the content and restarted confluence.  The new pages are listed in the sidebar but are not captured by the label gadgetnot in label macro, only on sidebar.png

also the sort by Page Name is not working in the macro

Any progress with this? I experience the same as @Maggie Secara1 does ... reboot, reindex, delete index and build it from scratch works... for that moment... after that no updates again until another reindex... thanks

Restart and hope it fixes it is not a solution. Neither is reindexing constantly. This is a key feature that a lot of people use. Atllassian - this needs to be addressed. It is not a new issue and has significant impact on sites like ours that have a lot of content. This issue is nearly 2 years old.

Is there any update on this issue? I'm having the same problem, and it seriously undermines the setup I'm working on. Also, I find it rather discouraging that the issue has apparently existed for over two years without anything being done about it.

I'm also having the same problem - NONE of my content by label macros are pulling data.  I'm building a brand new space and none of the pages I've built in the last week or so show in the Pages shortcut and none of the content macros are working.  

Has this been solved?

Same problem, index queue empty

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Confluence Cloud

Presenter Mode for Confluence is here 🖥 👩‍💻

👋  Hello Community!  My name is Stephanie Zhang, and I’m a product manager on the Confluence cloud team. Today, I’m excited to announce the rollout of  Presenter Mode : a ...

1,599 views 14 36
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you