List of pages in space — Confluence Cloud Macro

adminconfluence-contentformatting

This macro, "List of pages in space", retrieves and displays all pages within a given Confluence space in a sortable and filterable table. It uses the Confluence REST API to fetch the spaceId based on a provided space key, then queries all pages under that space. Each page is displayed with its title (linked to the page), last updated date, author (with profile link), and labels (linked to Confluence search by label). The table is styled using Atlassian AUI classes for a clean and consistent Confluence appearance. A filter input box above the table allows users to dynamically search pages by title, author, or labels, hiding rows that don’t match the search query. The filter logic is implemented in vanilla JavaScript for lightweight performance. Author information is conditionally styled: if the current user is the page creator, their name is highlighted with an in-progress lozenge, otherwise a subtle lozenge is used. Labels are fetched via an additional API call per page and displayed as clickable lozenges linking to label-based search. This macro improves space navigation by giving users a quick overview of all content, allowing efficient filtering without leaving the page. It is ideal for project documentation spaces, knowledge bases, and team wikis where content grows rapidly and structured discovery is essential

Try for free

User Parameters

key

space key

Template

#set ($spaceId = $ConfluenceManager.get("/wiki/api/v2/spaces?keys=$parameters['key']").results[0].id)

#set ( $pagesInSpace = $ConfluenceManager.get("/wiki/api/v2/spaces/$spaceId/pages") )

#set ($format = "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'")

<input type="text" id="filterInput" placeholder="Filter by title or label..." 
       style="margin-bottom: 10px; padding: 5px; width: 200px; border: 2px solid #0B120E24; border-radius: 4px;">
<table class="aui aui-table-sortable" id="pagesTable" border="1" cellspacing="0" cellpadding="5" style="border: none;">
    <thead>
        <tr>
            <th>Name</th>
            <th>Last Updated Date</th>
            <th>Created By</th>
            <th>Labels</th>
        </tr>
    </thead>
    <tbody>
        #foreach ($pageInSpace in $pagesInSpace.results)
        
            #set ($pageLink = $pageInSpace._links.webui)
            <tr>
                <td><a href="$pageLink" target="_blank">$pageInSpace.title</a></td>
                <td>$DateUtils.parseDate($pageInSpace.createdAt, $format)</td>
                #set ($isCurrentUser = $StringUtils.equals($user.accountId, $pageInSpace.authorId))
                #if ($isCurrentUser)
                    #set ($blueStyle = "aui-lozenge-inprogress")
                    #set ($author = $user)
                #else
                    #set ($blueStyle = "aui-lozenge-subtle")
                    #set ($author = $ConfluenceManager.get("/wiki/rest/api/user?accountId=$pageInSpace.authorId"))
                #end
                <td>
                    <a href="${baseUrl}/people/${author.accountId}">
                        <span class="aui-lozenge $blueStyle">
                            @$author.displayName
                        </span>
                    </a>
                </td>
                
                
                #set ($pageLabels = $ConfluenceManager.get("/wiki/api/v2/pages/$pageInSpace.id/labels").results)
                <td>
                    #foreach ($label in $pageLabels)
                    ##https://wombats.atlassian.net/wiki/search?product=confluence&labels=second_round
                      <a href = "${baseUrl}/search?product=confluence&labels=${label.name}">
                      <span class="aui-lozenge aui-lozenge-subtle">$label.name</span>
                      </a>
                    #end
                </td>
            </tr>
        #end
    </tbody>
</table>

<script>
document.getElementById("filterInput").addEventListener("keyup", function() {
    let filter = this.value.toLowerCase().trim();
    let rows = document.querySelectorAll("#pagesTable tbody tr");

    rows.forEach(row => {
        // Grab all cells
        let cells = row.querySelectorAll("td");

        // Take only: 0 (Name), 2 (Created By), 3 (Labels)
        let rowText = (
            cells[0].textContent + " " + 
            cells[2].textContent + " " + 
            cells[3].textContent
        ).toLowerCase();

        // Show/hide depending on match
        row.style.display = rowText.includes(filter) ? "" : "none";
    });
});
</script>

Recommended Macros

Show Labels for Space

Retrieve and display labels from a specified space.

Show Pages List for Label

Display a list of Confluence pages with CSV download feature

Usercount for Every Space

Display information about how many users have access to each space

User List by Email Filter

Display Confluence users filtered by their email addresses.

Advanced Table

Improve default Confluence tables with sorting, filtering, pagination, and CSV export features

Image from Attachments

Find image within page attachments. Handy for reuse files and update them all at once

Issue Filter

User macro for displaying issues using custom JQL filter

Multiselect Dropdown MenuNew

Create dropdown menus in Confluence Cloud with predefined sets of options, multiselect features, and permission gates