Pasted a GitHub URL and it did not turn into a macro

Updated
View as text
Open in Confluence
Open in ChatGPT Open in Claude

What you are seeing

I pasted a GitHub URL and it did not turn into a macro.

#Why it happens

Only github.com /blob/ links and raw.githubusercontent.com links auto-convert, and only up to 10 path segments after the branch. Directory (tree/) links, gist links, GitHub Enterprise hosts, www.github.com and very deep paths are not matched.

#What to do

Use a plain github.com /blob/ file link, or insert the macro from the macro browser and pick the file through Browse GitHub.

#Settings involved

Setting

Where

What it does

There is no GitHub settings screen

Nowhere

The git capability declares no global settings tab and no space settings tab, so GitHub contributes nothing to Capable global settings or space settings. There is also no admin "connect the site to GitHub" screen, becaus

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.

#Limits that apply here

Limit

Value

What happens

Auto-convert: only two hosts

-

Github.com blob links and raw.githubusercontent.com links only. Directory (tree/) links, gists and GitHub Enterprise hosts do not convert.

Image rendering capped at 800px tall

-

-

Code viewer capped at 600px tall

-

-

Found it? Good.