Skip to main content

Version control n8n workflows in GitLab with customer tag organization

Workflow preview

Workflow preview
100%
Version control n8n workflows in GitLab with customer tag organization preview
Open on n8n.io

Important notice

This workflow is provided as-is. Please review and test before using in production.

1. Workflow Overview

How it works Triggers manually or on schedule (03:00 daily by default) Fetches workflows tagged via n8n API Normalizes workflow names and applies tag convention Prepares JSON in the same structure ...

Best for

  • DevOps automation workflows
  • advanced n8n builders looking for reusable templates

Tools used

n8n-nodes-base.manualtrigger, n8n-nodes-base.scheduletrigger, n8n-nodes-base.code, n8n-nodes-base.stickynote, n8n-nodes-base.n8n, n8n-nodes-base.gitlab, n8n-nodes-base.set, n8n-nodes-base.if

Source and attribution

This workflow is cataloged by N8N Workflows and links back to its original n8n.io source page by Omar Kennouche.

Original n8n.io source

1.1 Workflow description

Title
Version control n8n workflows in GitLab with customer tag organization
Workflow name
Version control n8n workflows in GitLab with customer tag organization

How it works

  • Triggers manually or on schedule (03:00 daily by default)
  • Fetches workflows tagged backup-workflows via n8n API
  • Normalizes workflow names and applies [client: NAME] tag convention
  • Prepares JSON in the same structure as an n8n UI export
  • Checks GitLab repository:
    • Create new file if missing
    • Update file if content differs
    • Skip if unchanged
  • Logs results with recap (created, updated, unchanged, total)

Set up steps

  • Configure your GitLab credentials in n8n
  • Create a repository and branch for workflow backups
  • Set global variables (owner, project, branch, backup path)
  • Tag workflows to include with backup-workflows
  • Run manually once to test, then enable the schedule

1.2 Logical Blocks

This catalog entry is organized from the workflow JSON. The node-level section below shows the executable blocks available for review before importing the template.

2. Block-by-Block Analysis

Block 1 - When clicking ‘Execute workflow’

Type / Role
n8n-nodes-base.manualTrigger - manualTrigger
Config choices
Version 1

Block 2 - Schedule Trigger

Type / Role
n8n-nodes-base.scheduleTrigger - scheduleTrigger
Config choices
Version 1.2

Block 3 - Prepare Workflow JSON for UI-Compatible Export

Type / Role
n8n-nodes-base.code - code
Config choices
Version 2

Block 4 - Clean & Normalize Workflow Name

Type / Role
n8n-nodes-base.code - code
Config choices
Version 2

Block 5 - Sticky Note

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 6 - Sticky Note2

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 7 - Sticky Note4

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 8 - Sticky Note6

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 9 - Fetch Workflows from n8n

Type / Role
n8n-nodes-base.n8n - n8n
Config choices
Version 1

Block 10 - Fetch Existing File from GitLab

Type / Role
n8n-nodes-base.gitlab - gitlab
Config choices
Version 1

Block 11 - Update Existing File in GitLab

Type / Role
n8n-nodes-base.gitlab - gitlab
Config choices
Version 1

Block 12 - Create New File in GitLab

Type / Role
n8n-nodes-base.gitlab - gitlab
Config choices
Version 1

Block 13 - Normalize Backup Output

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

Block 14 - Set Global GitLab Variables

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

Block 15 - Prepare GitLab File Path

Type / Role
n8n-nodes-base.code - code
Config choices
Version 2

Block 16 - Compare Workflow with GitLab Version

Type / Role
n8n-nodes-base.if - if
Config choices
Version 2.2

Block 17 - Sticky Note7

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 18 - Sticky Note1

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 19 - Sticky Note3

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 20 - Mark as Created

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

Block 21 - Mark as Updated

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

Block 22 - Mark as Unchanged

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

Block 23 - Summarize Backup Results

Type / Role
n8n-nodes-base.code - code
Config choices
Version 2

Block 24 - Merge

Type / Role
n8n-nodes-base.merge - merge
Config choices
Version 3.2

3. Summary Table

Workflow Version control n8n workflows in GitLab with customer tag organization
Complexity advanced
Nodes 24
Categories DevOps
Author Omar Kennouche
Published 29 Aug 2025

4. Reproducing the Workflow from Scratch

  1. 1. Download the workflow JSON

    Use the JSON export at /data/workflows/8042/8042.json as the source template for this automation.

  2. 2. Import the template into n8n

    Open n8n, import the downloaded JSON, and review each node before activating the workflow.

  3. 3. Configure credentials and variables

    Replace placeholder credentials, API keys, webhook URLs, account IDs, and environment-specific values with your own settings.

  4. 4. Test with sample data

    Run the workflow manually or in a staging workspace, inspect node output, and confirm downstream systems receive the expected data.

  5. 5. Activate and monitor

    Enable the workflow only after testing, then monitor executions, errors, and rate limits during the first production runs.

5. General Notes & Resources

Review imported nodes carefully before activation. This catalog entry is intended to help you inspect the workflow structure, understand required services, and find related templates faster.

Node names, credentials, schedules, webhook paths, and external service limits may need adjustment for your workspace.

Frequently asked questions

What does Version control n8n workflows in GitLab with customer tag organization do?

How it works Triggers manually or on schedule (03:00 daily by default) Fetches workflows tagged via n8n API Normalizes workflow names and applies tag convention Prepares JSON in the same structure ...

What do I need before importing this workflow?

Review the workflow JSON, configure any required credentials in n8n, and test the automation in a safe workspace before using it in production.

Can I customize this workflow?

Yes. Use the block-by-block analysis and the downloadable JSON to inspect each node, then adjust credentials, prompts, schedules, filters, or destinations for your DevOps use case.