Something is missing or looks wrong
Start from what you are seeing rather than from what you think is broken. Each page below names the symptom, explains why it happens, and says what to do about it.
Several of these are the product working as designed, which is worth knowing before anybody raises a ticket.
#At a glance
Symptom | Usually because |
|---|---|
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 are fetched in a single unpaginated call. |
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 the page is saved and indexed. Until indexing catches up, the page is not filterable. |
"Github" byline is missing on a very large page even though it clearly has GitHub macros | Confluence caps the content property at 32 KB, and the trimmer empties the macro-key list to fit. But that list is one of the conditions the byline checks before showing. |
Byline is missing everywhere, or in one space | Either an admin has hidden the capability site-wide via the hidden-capabilities app property, or the space has it in its always-off list. Unlicensed and logged-out readers also never see the |
Exported the page to PDF or Word and the GitHub file is missing, with no explanation | |
Macro shows "This file is empty" | 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. |
#In this section
#Related
Most of these are expected behaviour.
