# Pasted a link like github.com/owner/repo/blob/refs/heads/main/file.md and the macro is broken

**What you are seeing**

I pasted a link like github.com/owner/repo/blob/refs/heads/main/file.md and the macro is broken.

---

## Why it happens

The parser used by auto-convert takes the third path segment as the branch without checking, so it reads the branch as "refs" and the file path as "heads/main/file.md". The picker's own parser handles this form correctly, but auto-convert does not use it.

---

## What to do

Paste the short form instead, or fix the macro by re-picking 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. |
| Connect polling gives up after 30 seconds | \-        | \-                                                                                                                                         |
| No caching of file content                | \-        | Every render of a GitHub-file macro re-fetches the file. A page with many GitHub macros consumes GitHub API budget on every view.          |

---

## Related

[Logged-out readers see a sign-in notice instead of the fileFor an anonymous reader the app tries the public raw fetch and nothing else. Deliberately,](https://help.gocapable.com/git/logged-out-readers-see-a-sign-in-notice-instead-of-the-file.html)

[Disconnect button does nothingEvery Disconnect control just shows a message telling you where to go.](https://help.gocapable.com/git/disconnect-button-does-nothing.html)

[Everything elseThe rest of this family.](https://help.gocapable.com/git/everything-else.html)

---

_Found it? Good._