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 | The picker only loads the first 100 branches, and folder listings load in one go with no further pages. Anything beyond that does not show. |
Just added a GitHub macro but the page does not appear in search or in the Capable → Github catalogue | GitHub search relies on the page being indexed after you save it. Until indexing catches up, the page cannot be filtered. |
"Github" byline is missing on a very large page even though it clearly has GitHub macros | Confluence limits how much GitHub information it can store for one page, so on a very large page the app trims it to fit. The byline needs that information to appear, so it stays hidden. |
Byline is missing everywhere, or in one space | Either an admin has hidden the capability across the whole site, or the space has it switched off. 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 empty, with zero bytes. Every viewer sees this message, rather than a blank space or a diagram that never finishes loading. |
#In this section
#Related
Most of these are expected behaviour.
