Macro shows "This file is empty"
What you are seeing
The macro shows "This file is empty".
#Why it happens
The file really is zero bytes or empty. This message is shown to every viewer, rather than a blank viewer or a stuck diagram skeleton.
#What to do
Check the file in GitHub. It is genuinely empty at the branch you configured.
#Settings involved
Setting | Where | What it does |
|---|---|---|
Hide GitHub across the whole site | App property `capable-global-hidden-capabilities`, object name `hiddenCapabilities`, value | Hides the capability tenant-wide. IMPORTANT: this gates the BYLINE ONLY. The macro module has no display conditions, so hiding the capability does not stop existing GitHub macros from rendering on pages. |
Turn GitHub on or off per space | Space property `<APP_HASH>_capable`, object name `capabilities.alwaysOff` / `capabilities. | AlwaysOff suppresses the byline in that space; alwaysOn shows it even on pages with no GitHub macro. Again, byline only. Macros still render. |
Unlicensed and anonymous access | Not user-configurable | Granted on the MACRO module only, for both 'unlicensed' and 'anonymous'. So a reader outside the licence, or logged out entirely, still sees public file content in the degraded read-only branch. But gets no "Github" byli |
#Limits that apply here
Limit | Value | What happens |
|---|---|---|
Public repository search: first page only | - | Search runs only when a query is typed and page === 1. Paging past page 1 shows only the person's own repositories. |
Image rendering capped at 800px tall | - | - |
Code viewer capped at 600px tall | - | - |
#Related
Branch or a folder entry I expect is missing from the picker
Only the first 100 branches are ever fetched, with no pagination, and directory listings a
Just added a GitHub macro but the page does not appear in search or in the Capable → Github catalogu
All the GitHub search fields come from Confluence's content-property index, written after
Something is missing or looks wrong
The rest of this family.
Found it? Good.
