> For the complete documentation index, see [llms.txt](https://docs.n8n.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.git.md).

# Git

[Git](https://git-scm.com/) is a free and open-source distributed version control system designed to handle everything from small to large projects with speed and efficiency.

{% hint style="info" %}
**Credentials**

You can find authentication information for this node [here](/integrations/builtin/credentials/git.md).
{% endhint %}

## Operations <a href="#operations" id="operations"></a>

* **Add** a file or folder to commit. Performs a [git add](https://git-scm.com/docs/git-add).
* **Add Config**: Add configuration property. Performs a [git config](https://git-scm.com/docs/git-config) set or add.
* **Clone** a repository: Performs a [git clone](https://git-scm.com/docs/git-clone).
* **Commit** files or folders to git. Performs a [git commit](https://git-scm.com/docs/git-commit).
* **Fetch** from remote repository. Performs a [git fetch](https://git-scm.com/docs/git-fetch).
* **List Config**: Return current configuration. Performs a [git config](https://git-scm.com/docs/git-config) query.
* **Log**: Return git commit history. Performs a [git log](https://git-scm.com/docs/git-log).
* **Pull** from remote repository: Performs a [git pull](https://git-scm.com/docs/git-pull).
* **Push** to remote repository: Performs a [git push](https://git-scm.com/docs/git-push).
* **Push Tags** to remote repository: Performs a [git push --tags](https://git-scm.com/docs/git-push#Documentation/git-push.txt---tags).
* Return **Status** of current repository: Performs a [git status](https://git-scm.com/docs/git-status).
* **Switch Branch:** Performs a [git switch](https://git-scm.com/docs/git-switch).
* Create a new **Tag**: Performs a [git tag](https://git-scm.com/docs/git-tag).
* **User Setup**: Set the user.

Refer to the sections below for more details on the parameters and options for each operation.

## Add <a href="#add" id="add"></a>

Configure this operation with these parameters:

* **Repository Path**: Enter the local path of the git repository.
* **Paths to Add**: Enter a comma-separated list of paths of files or folders to add in this field. You can use absolute paths or relative paths from the **Repository Path**.

## Add Config <a href="#add-config" id="add-config"></a>

Configure this operation with these parameters:

* **Repository Path**: Enter the local path of the git repository.
* **Key**: Enter the name of the key to set.
* **Value**: Enter the value of the key to set.

### Add Config options <a href="#add-config-options" id="add-config-options"></a>

The add config operation adds the **Mode** option. Choose whether to **Set** or **Append** the setting in the local config.

## Clone <a href="#clone" id="clone"></a>

Configure this operation with these parameters:

* **Repository Path**: Enter the local path of the git repository.
* **Authentication**: Select **Authenticate** to pass credentials in. Select **None** to not use authentication.
  * **Credential for Git**: If you select **Authenticate**, you must select or create credentials for the node to use. Refer to [Git credential](/integrations/builtin/credentials/git.md) for more information.
* **New Repository Path**: Enter the local path where you'd like to locate the cloned repository.
* **Source Repository**: Enter the URL or path of the repository you want to clone.

## Commit <a href="#commit" id="commit"></a>

Configure this operation with these parameters:

* **Repository Path**: Enter the local path of the git repository.
* **Message**: Enter the commit message to use in this field.

### Commit options <a href="#commit-options" id="commit-options"></a>

The commit operation adds the **Paths to Add** option. To commit all "added" files and folders, leave this field blank. To commit specific "added" files and folders, enter a comma-separated list of paths of files or folders in this field.

You can use absolute paths or relative paths from the **Repository Path**.

## Fetch <a href="#fetch" id="fetch"></a>

This operation only prompts you to enter the local path of the git repository in the **Repository Path** parameter.

## List Config <a href="#list-config" id="list-config"></a>

This operation only prompts you to enter the local path of the git repository in the **Repository Path** parameter.

## Log <a href="#log" id="log"></a>

Configure this operation with these parameters:

* **Repository Path**: Enter the local path of the git repository.
* **Return All**: When turned on, the node will return all results. When turned off, the node will return results up to the set **Limit**.
* **Limit**: Only available when you turn off **Return All**. Enter the maximum number of results to return.

### Log options <a href="#log-options" id="log-options"></a>

The log operation adds the **File** option. Enter the path of a file or folder to get the history of in this field.

You can use absolute paths or relative paths from the **Repository Path**.

## Pull <a href="#pull" id="pull"></a>

This operation only prompts you to enter the local path of the git repository in the **Repository Path** parameter.

## Push <a href="#push" id="push"></a>

Configure this operation with these parameters:

* **Repository Path**: Enter the local path of the git repository.
* **Authentication**: Select **Authenticate** to pass credentials in or **None** to not use authentication.
  * If you select **Authenticate**, you must select or create **Credential for Git** for the node to use. Refer to [Git credential](/integrations/builtin/credentials/git.md) for more information.

### Push options <a href="#push-options" id="push-options"></a>

The push operation adds the **Target Repository** option. Enter the URL or path of the repository to push to in this field.

## Push Tags <a href="#push-tags" id="push-tags"></a>

This operation only prompts you to enter the local path of the git repository in the **Repository Path** parameter.

## Status <a href="#status" id="status"></a>

This operation only prompts you to enter the local path of the git repository in the **Repository Path** parameter.

## Switch Branch <a href="#switch-branch" id="switch-branch"></a>

Configure this operation with these parameters:

* **Repository Path**: Enter the local path of the git repository.
* **Branch Name**: Enter the name of the branch to which you want to switch.

## Tag <a href="#tag" id="tag"></a>

Configure this operation with these parameters:

* **Repository Path**: Enter the local path of the git repository.
* **Name**: Enter the name of the tag to create in this field.

## User Setup <a href="#user-setup" id="user-setup"></a>

This operation only prompts you to enter the local path of the git repository in the **Repository Path** parameter.

## Templates and examples <a href="#templates-and-examples" id="templates-and-examples"></a>

[Browse Git integration templates](https://n8n.io/integrations/git) or [search all templates](https://n8n.io/workflows/)