diff --git a/.github/workflows/update-metadata.yml b/.github/workflows/update-metadata.yml
new file mode 100644
index 000000000..39f5889ab
--- /dev/null
+++ b/.github/workflows/update-metadata.yml
@@ -0,0 +1,23 @@
+# This job requires a secret called DOCS_TOKEN which should be a PAT token
+# that has the permissions described in:
+# validatedpatterns/docs/.github/workflows/metadata-docs.yml@main
+---
+name: Update docs pattern metadata
+
+on:
+  push:
+    paths:
+      - "pattern-metadata.yaml"
+      - ".github/workflows/update-metadata.yml"
+
+jobs:
+  update-metadata:
+    uses: validatedpatterns/docs/.github/workflows/metadata-docs.yml@main
+    permissions: # Workflow-level permissions
+      contents: read  # Required for "read-all"
+      packages: write # Allows writing to packages
+      id-token: write # Allows creating OpenID Connect (OIDC) tokens
+    secrets: inherit
+    # For testing you can point to a different branch in the docs repository
+    # with:
+    #  DOCS_BRANCH: "main"
diff --git a/pattern-metadata.yaml b/pattern-metadata.yaml
new file mode 100644
index 000000000..fdb3a0d13
--- /dev/null
+++ b/pattern-metadata.yaml
@@ -0,0 +1,70 @@
+# This goal of this metadata is mainly used as a source of truth for
+# documentation and qe
+metadata_version: "1.0"
+name: multicloud-gitops
+pattern_version: "1.0"
+display_name: Multicloud Gitops
+repo_url: https://github.com/validatedpatterns/multicloud-gitops
+docs_repo_url: https://github.com/validatedpatterns/docs
+issues_url: https://github.com/validatedpatterns/multicloud-gitops/issues
+docs_url: https://validatedpatterns.io/patterns/multicloud-gitops/
+ci_url: https://validatedpatterns.io/ci/?pattern=mcgitops
+# can be sandbox, tested or maintained
+tier: maintained
+owners: mbaldessari, darkdoc
+requirements:
+  hub: # Main cluster
+    compute:
+      platform:
+        gcp:
+          replicas: 3
+          type: n1-standard-8
+        azure:
+          replicas: 3
+          type: Standard_D8s_v3
+        aws:
+          replicas: 3
+          type: m5.2xlarge
+    controlPlane:
+      platform:
+        gcp:
+          replicas: 3
+          type: n1-standard-4
+        azure:
+          replicas: 3
+          type: Standard_D4s_v3
+        aws:
+          replicas: 3
+          type: m5.xlarge
+  spoke: # optional - represents the clusters imported into ACM
+    compute:
+      platform:
+        gcp:
+          replicas: 0
+          type: n1-standard-8
+        azure:
+          replicas: 0
+          type: Standard_D8s_v3
+        aws:
+          replicas: 0
+          type: m5.2xlarge
+    controlPlane:
+      platform:
+        gcp:
+          replicas: 3
+          type: n1-standard-8
+        azure:
+          replicas: 3
+          type: Standard_D8s_v3
+        aws:
+          replicas: 3
+          type: m5.2xlarge
+
+# Loosely defined extra features like hypershift support, non-openshift
+# kubernetes support, spoke support
+extra_features:
+  hypershift_support: true
+  spoke_support: true
+
+external_requirements:
+# external quay, s3 bucket, agof tokens to access paywalled material, manifests, rag-llm hw (only selected regions)