{"id":17223,"date":"2026-05-11T14:05:15","date_gmt":"2026-05-11T08:05:15","guid":{"rendered":"https:\/\/betterdocs.co\/?post_type=docs&p=17223"},"modified":"2026-05-11T14:05:21","modified_gmt":"2026-05-11T08:05:21","password":"","slug":"connect-the-gitlab-repository-to-betterdocs","status":"publish","type":"docs","link":"https:\/\/betterdocs.co\/it\/docs\/connect-the-gitlab-repository-to-betterdocs\/","title":{"rendered":"How to Connect the GitLab Repository to BetterDocs"},"content":{"rendered":"

Introducing Git Integration in BetterDocs PRO<\/strong><\/a>, a smarter, faster way to keep your documentation synced directly with your Git account. Follow the guide below to explore how to connect the GitLab repository to BetterDocs to get started seamlessly.<\/p>\n\n\n\n

Step 1: Configure BetterDocs Settings<\/strong><\/h2>\n\n\n\n

To begin, navigate to BetterDocs 'Impostazioni'<\/strong> and open the \u2018Git Sync\u2019<\/strong> tab. From there, you can configure and manage the connection with your Git account. Simply toggle the \u2018Enable\u2019<\/strong> option to start syncing your GitLab account seamlessly. <\/p>\n\n\n\n

Nota:<\/em><\/strong> To connect your GitHub account, check the step-by-step process in this documentation.<\/a><\/strong> <\/em><\/p>\n\n\n

\n
\"Connect<\/figure>\n<\/div>\n\n\n

Step 2: Connect Your GitLab Account<\/strong><\/h2>\n\n\n\n

To connect your account with GitLab, enter your GitLab Project ID and Access Token. Create a token at GitLab Settings \u2192 Access Tokens<\/strong><\/a>. From there, copy the token ID and project ID. Then paste it in your BetterDocs settings. Click on the \u2018Connect GitLab\u2019<\/strong> button. After that, your GitLab account will be automatically connected to BetterDocs.<\/p>\n\n\n

\n
\"Add<\/figure>\n<\/div>\n\n\n

Step 3: Configure the GitLab Integration Settings<\/strong><\/h2>\n\n\n\n

Now, after connecting with your GitLab account with Project ID and Access Token, select the repository where you want to sync the documentation. After selecting it, select the specific branch and doc directory. Next, configure the \u2018File Naming Convention<\/strong>\u2019 to define how Markdown files will be named in your repository. You can also enable or disable the \u2018Auto Sync\u2019<\/strong> option to automatically sync documentation changes with Git whenever docs are saved. Once everything is set up, click the \u2018Save\u2019<\/strong> button to apply your changes. <\/p>\n\n\n

\n
\"Configure<\/figure>\n<\/div>\n\n\n

Step 4: Sync the Documentation<\/strong><\/h2>\n\n\n\n

Go back to the documentation that you want to sync in your Git repository. There, you will find an option on the top right side of the documentation named \u2018GitLab Sync.\u2019<\/strong> <\/p>\n\n\n

\n
\"Sync<\/figure>\n<\/div>\n\n\n

Click the button to access the option for pushing the doc to your GitLab repository. Once the document is fetched successfully, add a \u2018Summary\u2019<\/strong> for your documentation and include a description if needed. Finally, click the \u2018Commit & Push to\u2019<\/strong> button to publish the documentation to your selected branch.<\/p>\n\n\n

\n
\"Push<\/figure>\n<\/div>\n\n\n

You will also find options to \u2018Pull from GitLab\u2019<\/strong> e \u2018Import MD Files\u2019<\/strong>. If any changes are made to the documentation in your GitLab repository, simply click \u2018Pull from GitLab<\/strong>\u2019 to automatically sync and apply those updates to your BetterDocs documentation.<\/p>\n\n\n

\n
\"Pull<\/figure>\n<\/div>\n\n\n

Similarly, you can import all the MD files from your GitLab repository right inside your BetterDocs documentation. Click on \u2018Import MD Files\u2019 <\/strong>and select the documentation you want to import. Then click on the \u2018Import Selected\u2019<\/strong> button to import the file.<\/p>\n\n\n

\n
\"Import<\/figure>\n<\/div>\n\n\n

Esito finale<\/strong><\/h2>\n\n\n\n

Finally, in your Git Repository, you will see that the documentation is synced with your BetterDocs knowledge base. This is how you can easily document on BetterDocs and a GitLab account.<\/p>\n\n\n

\n
\"GitLab<\/figure>\n<\/div>\n\n\n

If you face any difficulties, feel free to contact our support team<\/strong><\/a>.<\/p>\n\n\n\n

<\/p>","protected":false},"excerpt":{"rendered":"

Step-by-step process of connecting GitLab repository with BetterDocs in the feature Git Sync. <\/p>","protected":false},"author":44,"featured_media":17231,"template":"","meta":{"_eb_attr":"","inline_featured_image":false,"_eb_data_table":"","_analytify_skip_tracking":false,"footnotes":""},"doc_category":[309],"doc_tag":[1388,1390,1389,1387],"knowledge_base":[282],"class_list":["post-17223","docs","type-docs","status-publish","has-post-thumbnail","hentry","doc_category-configurations","doc_tag-git-sync","doc_tag-gitlab-integration","doc_tag-gitlab-repository","doc_tag-gitlab-sync","knowledge_base-wordpress"],"year_month":"2026-05","word_count":457,"total_views":"40","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"Maahi","author_nicename":"maahi","author_url":"https:\/\/betterdocs.co\/it\/author\/maahi\/"},"doc_category_info":[{"term_name":"Configurations","term_url":"https:\/\/betterdocs.co\/it\/docs\/shopify\/configurations\/"}],"doc_tag_info":[{"term_name":"Git Sync","term_url":"https:\/\/betterdocs.co\/it\/docs-tag\/git-sync\/"},{"term_name":"GitLab integration","term_url":"https:\/\/betterdocs.co\/it\/docs-tag\/gitlab-integration\/"},{"term_name":"GitLab repository","term_url":"https:\/\/betterdocs.co\/it\/docs-tag\/gitlab-repository\/"},{"term_name":"GitLab sync","term_url":"https:\/\/betterdocs.co\/it\/docs-tag\/gitlab-sync\/"}],"knowledge_base_info":[{"term_name":"WordPress","term_url":"https:\/\/betterdocs.co\/it\/docs\/wordpress\/","term_slug":"wordpress"}],"knowledge_base_slug":["wordpress"],"_links":{"self":[{"href":"https:\/\/betterdocs.co\/it\/wp-json\/wp\/v2\/docs\/17223","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/betterdocs.co\/it\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/betterdocs.co\/it\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/betterdocs.co\/it\/wp-json\/wp\/v2\/users\/44"}],"version-history":[{"count":3,"href":"https:\/\/betterdocs.co\/it\/wp-json\/wp\/v2\/docs\/17223\/revisions"}],"predecessor-version":[{"id":17245,"href":"https:\/\/betterdocs.co\/it\/wp-json\/wp\/v2\/docs\/17223\/revisions\/17245"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/betterdocs.co\/it\/wp-json\/wp\/v2\/media\/17231"}],"wp:attachment":[{"href":"https:\/\/betterdocs.co\/it\/wp-json\/wp\/v2\/media?parent=17223"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/betterdocs.co\/it\/wp-json\/wp\/v2\/doc_category?post=17223"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/betterdocs.co\/it\/wp-json\/wp\/v2\/doc_tag?post=17223"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/betterdocs.co\/it\/wp-json\/wp\/v2\/knowledge_base?post=17223"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}