Permissions and access
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 |
|---|---|
There is a Description setting but I cannot find anywhere to type one, and nothing shows | The picker's save routine does not even write the key. |
Cannot find the GitHub macro in Capable's macro list, the command palette, or the automation "Insert | The macro is deliberately marked as hidden from Capable's own listings. |
Readers see "Connect a GitHub account with access to this repository to view this file" | The file is in a private repository and that reader has no connected GitHub account that can reach it. Access is always per-person; there is no site-wide or admin-level GitHub connection. |
Admin wants to connect GitHub once on behalf of the whole site, and cannot find the setting | There is no site-level or admin-level GitHub connection, and no GitHub settings tab anywhere in Capable global or space settings. Authentication is per-user only. |
Macro cannot find a file in a repository that still uses "master" | The default branch is 'main' throughout. Only the Appfire File migrator defaults to 'master'. |
Cannot choose a different branch in the Browse GitHub picker | There is no branch picker in the Confluence file browser. The branch list is fetched but the result is discarded; the branch is only ever set from the repository's default branch or from a p |
Cannot find a public repository I do not belong to in the picker | Public repositories you are not a member of appear only through search, and only on the first page of results. Paging past page 1 shows only your own repositories. |
Cannot filter search for image files | 'image' is a valid stored value and has its own catalogue sub-section, but it is missing from the seven options offered by the File Type filter in the search UI. |
Macro says none of my accounts have access, but I am certain I do | Very likely GitHub rate limiting. A 403 from GitHub is classified as an access error regardless of why it was returned, and there is no rate-limit detection, retry or backoff anywhere in the |
Cannot find a "Connections" area on the Capable → Github page |
#In this section
#Related
Most of these are expected behaviour.
