Issue Summary

In Confluence Data Center (observed in 9.2.22), when a user previews a Space Template that contains macros dependent on page-level metadata (such as the Table of Contents macro or 3rd-party metadata macros like get-metadata), the preview pane displays raw technical error messages.

These errors occur because the template is not an actual page, so the macros lack the necessary context to render. However, the same template works perfectly once a page is actually created from it.

Suggested Improvement:
Instead of displaying technical stack traces or raw error details which can be confusing to users, the template preview should display a user-friendly placeholder message, such as:

"Preview not available for this macro (requires page context)"

Steps to Reproduce

1. Create a Space Template.

1. Add a Table of Contents macro to the template.

1. Click on Preview.

1. Observe the technical error displayed in the preview window.

Expected Results

A user-friendly message indicating that the macro cannot be rendered in preview mode.

Actual Results

Technical error details are displayed.

Workaround

Currently there is no known workaround for this behavior. A workaround will be added here when available