Set a Title in the Browse GitHub picker but no heading appears on the page

What you are seeing

I set a Title in the Browse GitHub picker but no heading appears on the page.

The picker preview step with a Title box showing sequence.mermaid above a rendered sequence diagram, and an Add to page button
The Title box sits above the preview and is filled with the file name until you type something else.

#Why it happens

The Title is saved, but the macro never shows it. The macro header always shows the owner, repository and file path instead.


#What to do

Don't rely on the Title field. If you want a heading, add a normal Confluence heading above the macro.


#Settings involved

Setting

Where

What it does

There is no GitHub settings screen

Nowhere

GitHub adds nothing to Capable global settings or space settings. There is also no admin screen for connecting the whole site to GitHub. Each person connects their own account.

Hide GitHub across the whole site

Site-wide administrator setting

Hides the GitHub byline everywhere. This affects the byline only. Existing GitHub macros keep showing their files.

Turn GitHub on or off per space

Per-space administrator setting

Always off hides the byline in that space. Always on shows it even on pages with no GitHub macro. Again, this affects the byline only. Macros still show their files.


#Limits that apply here

Limit

What happens

Pasted links: two kinds only

Only github.com file links and raw.githubusercontent.com links turn into a macro automatically. Folder links, gists and GitHub Enterprise links do not.

Connecting waits 30 seconds

If you have not finished connecting your account within 30 seconds, Capable stops waiting.

Files are not cached

Every view of the page fetches the file again. A page with many GitHub files uses up your GitHub request allowance on every view.


#A few things that catch people out

  • Of the settings you might expect to use, most do little. Show Line Numbers has no effect, because line numbers are always on. Title is saved but never shown. Description is never collected. Show Border only changes how the empty and error states look.



Found it? Good.