# Insert Images from Git

📝

Display images stored in your repositories directly in Confluence or Jira.

![Images from Github in Confluence](https://help.gocapable.com/images/77364a9d-6887-4f40-95fd-3dfcfcc38571.webp)

### [#](#before-you-start)Before you start

* Connect your Git account and confirm access to the repo/branch.

### [#](#supported-image-formats)Supported image formats

* `.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.bmp`, `.ico`, `.svg`

### [#](#insert-steps)Insert steps

1. Insert the Github File macro

![Insert Github File Macro in Confluence](https://help.gocapable.com/images/42e1a8af-63b0-4460-ae4b-d33baa1fdf72.webp)

1. Connect/select your account and choose a repository and branch.

![Browse repositories in Confluence](https://help.gocapable.com/images/76699d1b-fea8-4e58-8054-7fb7cdac8eb8.webp)

1. Navigate to the image file and select it.

![Browse repository files in Confluence](https://help.gocapable.com/images/684bd036-52eb-4e09-8e77-3447b6d48d44.webp)

1. (Optional) Set a title; the image will preview inline.
2. Insert to add the image to the page/work item.

### [#](#tips)Tips

* Very large images will be fit to the container while preserving aspect ratio.
* SVGs are displayed inline; ensure they don’t reference external assets that require additional permissions.

### [#](#permissions)Permissions

* Viewers must have access to the repository. Without access, they’ll be prompted to connect or see an access error.

### [#](#troubleshooting)Troubleshooting

* Image won’t load: Confirm the path and branch; ensure the file is one of the supported formats.
* Looks blurry: Upload higher-resolution images or use SVG for scalable graphics.