User Macro to Pull Headings from Different Page

Here's what I want to accomplish:

A user places a user macro on the page. The macro requires two fields:

  • Page Title
  • Heading Title

I want the macro to have ability to search the page title (like other macros do). After the page has been found, I would like the Heading Title drop-down list to populate with all the headings on that particular page. Then the user can select a heading, click Insert, and the macro produces a link to that heading.

Can this be done?

1 answer

Ask and ye shall receive:

## @noparams
<form class="aui top-label">
  <div class="field-group top-label">
    <label for="requested-page">Find headings on this page:</label> 
    <input id="requested-page" class="autocomplete-page text" data-max="10" data-none-message="No results" data-template="{id}">
    <label for="select-heading">Heading</label>
    <select class="select" id="select-heading" name="select-heading">
    <p> </p>
    <div id="link-output"></div>
jQuery("#requested-page").change(function() {
  setTimeout(function() {
    var pageId = jQuery("#requested-page").val();
      url: contextPath + "/rest/api/content/" + pageId + "?expand=body.view",
      success: function(response) {
        var pageData = jQuery("<div></div>").html(response.body.view.value);
        var headers = pageData.find(":header");
        headers.each(function() {
          jQuery("#select-heading").append('<option value="' + + '">' + this.innerHTML + '</option>');
        }).promise().done(function() {
          var linkAddress = response._links.webui + "#" + jQuery("#select-heading > option").first().attr("value");
          jQuery("#link-output").html('<a href="' + linkAddress + '">' + linkAddress + '</a>');
        jQuery("#select-heading").change(function() {
          var linkAddress = response._links.webui + "#" + this.value;
          jQuery("#link-output").html('<a href="' + linkAddress + '">' + linkAddress + '</a>');
  }, 100);

I couldn't test it extensively, but it worked on my system.  You must be running Confluence 5.5 or later.

You are correct, that does work for essentially what I described. Obviously, I described it a bit wrong. What I was looking for was this functionality INSIDE the macro. So when the user adds the macro to a page, the NAME OF MACRO dialog displays and requires you to specify the page on which to find headings, then populates the list of headings. Once selected, the macro is saved. When the page renders, it provides a link to that heading (maybe Page Title: Heading). I'll try to work with what you provided to make a macro do that, but my programming (and user macro writing) skills are a bit dull.

Suggest an answer

Log in or Sign up to answer
Community showcase
Posted Feb 06, 2019 in Confluence

Try out the new editing experience

Hi team, I’m Avinoam, a product manager on Confluence Cloud, and today I’m really excited to let the Community know that all customers can now try out the new editing experience and see some of the ...

1,436 views 110 8
Join discussion

Atlassian User Groups

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

Find a group

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

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you