diff --git a/apps/docs/content/references/github-integration.mdx b/apps/docs/content/references/github-integration.mdx
index dd309926..46d4844b 100644
--- a/apps/docs/content/references/github-integration.mdx
+++ b/apps/docs/content/references/github-integration.mdx
@@ -106,6 +106,8 @@ As an alternative to direct integration, you can use GitHub Actions to manage yo
 1. **Create Workflow Configuration**
 
    Create a new file at `.github/workflows/deploy.yaml` in your repository:
+   
+   Basic example:
 
    ```yaml
    name: Deploy to Zerops
@@ -121,7 +123,7 @@ As an alternative to direct integration, you can use GitHub Actions to manage yo
    
        steps:
          - name: Checkout code
-           uses: actions/checkout@v3
+           uses: actions/checkout@v7
    
          - name: Deploy with Zerops
            uses: zeropsio/actions@main
@@ -130,6 +132,31 @@ As an alternative to direct integration, you can use GitHub Actions to manage yo
              service-id: your-service-id
    ```
 
+   Example with tag matching:
+   
+   ```yaml
+   name: Deploy to Zerops on Tag
+
+   on:
+     push:
+       tags:
+         - 'v[0-9]+\.[0-9]+\.[0-9]+'  # Example: v1.0.0, v2.3.4
+
+   jobs:
+     deploy:
+       runs-on: ubuntu-latest
+
+       steps:
+         - name: Checkout code
+           uses: actions/checkout@v7
+
+         - name: Deploy with Zerops
+           uses: zeropsio/actions@main
+           with:
+             access-token: ${{ secrets.ZEROPS_TOKEN }}
+             service-id: your-service-id
+   ```
+
 2. **Generate Access Token**
 
    - Navigate to [**Settings > Access Token Management**](https://app.zerops.io/settings/token-management) in your Zerops dashboard