---
title: "GitHub Sync — Free Framer plugin · Best of Framer"
description: "Free Framer plugin · by Tommy D. Rossi · CMS. Sync your CMS with Github"
canonical: "https://framer.elliotli.dev/plugin/github-sync"
---

[Home](/)/[Plugins](/plugins)/[CMS](/plugins/category/cms)/GitHub Sync

# GitHub Sync

Sync your CMS with Github

[View on Framer](https://framer.com/marketplace/plugins/github-sync/?via=elliot-li)

![GitHub Sync preview image 1](https://framer.elliotli.dev/og/plugin/github-sync/516050e289ec0fad/1600x1200.jpg)

## Summary

Sync your CMS with Github

## Description

This plugin connects your GitHub Markdown content to your Framer CMS, simplifying website updates. It syncs all .md files from a designated GitHub repository folder to a Framer CMS collection.

## Frontmatter

Use front matter to add custom fields to your content, front matter is a section at the top of your markdown files that is defined in YAML and delimited by --- characters.

These front matter fields will be available in your Framer collection after importing.

## Markdown Rendering

The plugin will add Markdown (.md) files to your Framer CMS collection, preserving formatting and markdown semantics. This plugin will also work with .mdx files but custom react components and JavaScript code will be discarded.

## Importing files inside a base path

Specify a base path within your repository to target specific folders for syncing. This allows you to organize your Markdown content and selectively sync portions to different Framer collections.

## Relative Images and Links

Relative image and file paths are resolved by searching the entire repository for a matching file. For example, if your Markdown file contains !\[alt text\](./image.png), the plugin will search for image.png within the same directory as the Markdown file. It also checks for matches in other directories within the repository, handling cases where the path might be slightly different (e.g., assets/image.png). Absolute URLs are left untouched. If no matching file is found, the image or link is omitted to prevent broken links.

## Nested Content and Collections

This plugin flattens your GitHub file structure into a single list within the chosen Framer collection. Each Markdown file's path is reflected in its slug. For example, a file at docs/guides/getting-started.md will have a slug like docs/guides/getting-started. To create a true nested structure in Framer, you'll need to create multiple collections, each syncing with a different base path. For instance, one collection could sync with docs/guides and another with docs/tutorials.

## Public and Private Repositories

The plugin supports both public and private GitHub repositories. Connect securely to private repositories using a personal access token.

## Pricing

You can try the plugin with 5 syncs available for free. To sync more times you will need to buy a monthly add-on of $49.

## Rank history [How rankings work →](/terms#rankings)

-   All · #169

## Details

- **Author**: Tommy D. Rossi
- **Published**: 2024-11-26
- **Updated**: 2024-12-10
- **Added**: 2024-11-22
- **Categories**: CMS

## More across types

-   [Bend Video Carousel](/component/bend-video-carousel) — Axis Supply · $15 — Bend Video Carousel is an interactive video carousel for Framer that combines smooth movement with a curved, dimensional layout.
-   [CMS Archway Video](/component/cms-archway-video) — Axis Supply · Free — CMS Archway Video is a cinematic video carousel for Framer that combines continuously moving video cards with a distinctive arched shape.
-   [Reveal Nav CMS](/component/reveal-nav-cms) — TOC Studio · Free — CMS-connected hover nav menu

## More like this

-   [AssetHost](/plugin/assethost) — Builders Hub · Free — AssetHost
-   [Facet](/plugin/facet) — Halvard Studio · Free — Filter, search and sort CMS lists
-   [Apify Scraper Sync](/plugin/apify-to-cms) — Cliqto Media · Free — Scrape data straight into your CMS
-   [Inlet](/plugin/inlet) — Noah Manning · Free — Sync any JSON API into Framer CMS