woodpecker-ci · 6543 · Sep 24, 2025 · May 7, 2025 · May 7, 2025 · May 7, 2025
diff --git a/.cspell.json b/.cspell.json
@@ -47,6 +47,7 @@
     "datacenter",
     "DATASOURCE",
     "Debugf",
+    "Demilestoned",
     "desaturate",
     "devx",
     "dind",
@@ -116,6 +117,7 @@
     "mapstructure",
     "markdownlint",
     "mdbook",
+    "Milestoned",
     "memswap",
     "Metas",
     "mhmxs",

diff --git a/cmd/server/openapi/docs.go b/cmd/server/openapi/docs.go
@@ -4913,6 +4913,12 @@ const docTemplate = `{
                 "event": {
                     "$ref": "#/definitions/WebhookEvent"
                 },
+                "event_reason": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
                 "finished": {
                     "type": "integer"
                 },
@@ -5551,6 +5557,7 @@ const docTemplate = `{
                 "push",
                 "pull_request",
                 "pull_request_closed",
+                "pull_request_metadata",
                 "tag",
                 "release",
                 "deployment",
@@ -5561,6 +5568,7 @@ const docTemplate = `{
                 "EventPush",
                 "EventPull",
                 "EventPullClosed",
+                "EventPullMetadata",
                 "EventTag",
                 "EventRelease",
                 "EventDeploy",
@@ -5684,6 +5692,12 @@ const docTemplate = `{
                 "event": {
                     "type": "string"
                 },
+                "event_reason": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
                 "finished": {
                     "type": "integer"
                 },

diff --git a/docs/docs/20-usage/20-workflow-syntax.md b/docs/docs/20-usage/20-workflow-syntax.md
@@ -284,6 +284,7 @@ The available events are:
 - `push`: triggered when a commit is pushed to a branch.
 - `pull_request`: triggered when a pull request is opened or a new commit is pushed to it.
 - `pull_request_closed`: triggered when a pull request is closed or merged.
+- `pull_request_metadata`: triggered when a pull request metadata has changed (e.g. title, body, label, milestone, ...).
 - `tag`: triggered when a tag is pushed.
 - `release`: triggered when a release, pre-release or draft is created. (You can apply further filters using [evaluate](#evaluate) with [environment variables](./50-environment.md#built-in-environment-variables).)
 - `deployment`: triggered when a deployment is created in the repository. (This event can be triggered from Woodpecker directly. GitHub also supports webhook triggers.)

diff --git a/docs/docs/20-usage/50-environment.md b/docs/docs/20-usage/50-environment.md
diff --git a/docs/docs/30-administration/10-configuration/12-forges/11-overview.md b/docs/docs/30-administration/10-configuration/12-forges/11-overview.md
@@ -2,14 +2,15 @@
 
 ## Supported features
 
-| Feature                                                          | [GitHub](20-github.md) | [Gitea](30-gitea.md) | [Forgejo](35-forgejo.md) | [Gitlab](40-gitlab.md) | [Bitbucket](50-bitbucket.md) | [Bitbucket Datacenter](60-bitbucket_datacenter.md) |
-| ---------------------------------------------------------------- | :--------------------: | :------------------: | :----------------------: | :--------------------: | :--------------------------: | :------------------------------------------------: |
-| Event: Push                                                      |   :white_check_mark:   |  :white_check_mark:  |    :white_check_mark:    |   :white_check_mark:   |      :white_check_mark:      |                 :white_check_mark:                 |
-| Event: Tag                                                       |   :white_check_mark:   |  :white_check_mark:  |    :white_check_mark:    |   :white_check_mark:   |      :white_check_mark:      |                 :white_check_mark:                 |
-| Event: Pull-Request                                              |   :white_check_mark:   |  :white_check_mark:  |    :white_check_mark:    |   :white_check_mark:   |      :white_check_mark:      |                 :white_check_mark:                 |
-| Event: Release                                                   |   :white_check_mark:   |  :white_check_mark:  |    :white_check_mark:    |   :white_check_mark:   |             :x:              |                        :x:                         |
-| Event: Deploy¹                                                   |   :white_check_mark:   |         :x:          |           :x:            |          :x:           |             :x:              |                        :x:                         |
-| [Multiple workflows](../../../20-usage/25-workflows.md)          |   :white_check_mark:   |  :white_check_mark:  |    :white_check_mark:    |   :white_check_mark:   |      :white_check_mark:      |                 :white_check_mark:                 |
-| [when.path filter](../../../20-usage/20-workflow-syntax.md#path) |   :white_check_mark:   |  :white_check_mark:  |    :white_check_mark:    |   :white_check_mark:   |             :x:              |                 :white_check_mark:                 |
+| Feature                                                                                                                | [GitHub](20-github.md) | [Gitea](30-gitea.md) | [Forgejo](35-forgejo.md) | [Gitlab](40-gitlab.md) | [Bitbucket](50-bitbucket.md) | [Bitbucket Datacenter](60-bitbucket_datacenter.md) |
+| ---------------------------------------------------------------------------------------------------------------------- | ---------------------- | -------------------- | ------------------------ | ---------------------- | ---------------------------- | -------------------------------------------------- |
+| Event: Push                                                                                                            | :white_check_mark:     | :white_check_mark:   | :white_check_mark:       | :white_check_mark:     | :white_check_mark:           | :white_check_mark:                                 |
+| Event: Tag                                                                                                             | :white_check_mark:     | :white_check_mark:   | :white_check_mark:       | :white_check_mark:     | :white_check_mark:           | :white_check_mark:                                 |
+| Event: Pull-Request                                                                                                    | :white_check_mark:     | :white_check_mark:   | :white_check_mark:       | :white_check_mark:     | :white_check_mark:           | :white_check_mark:                                 |
+| Event: Release                                                                                                         | :white_check_mark:     | :white_check_mark:   | :white_check_mark:       | :white_check_mark:     | :x:                          | :x:                                                |
+| Event: Deploy¹                                                                                                         | :white_check_mark:     | :x:                  | :x:                      | :x:                    | :x:                          | :x:                                                |
+| [Event: Pull-Request-Metadata](../../../20-usage/50-environment.md#pull_request_metadata-specific-event-reason-values) | :white_check_mark:     | :white_check_mark:   | :white_check_mark:       | :white_check_mark:     | :x:                          | :x:                                                |
+| [Multiple workflows](../../../20-usage/25-workflows.md)                                                                | :white_check_mark:     | :white_check_mark:   | :white_check_mark:       | :white_check_mark:     | :white_check_mark:           | :white_check_mark:                                 |
+| [when.path filter](../../../20-usage/20-workflow-syntax.md#path)                                                       | :white_check_mark:     | :white_check_mark:   | :white_check_mark:       | :white_check_mark:     | :x:                          | :white_check_mark:                                 |
 
 ¹ The deployment event can be triggered for all forges from Woodpecker directly. However, only GitHub can trigger them using webhooks.
diff --git a/pipeline/frontend/metadata/const.go b/pipeline/frontend/metadata/const.go
@@ -16,16 +16,27 @@ package metadata
 
 // Event types corresponding to forge hooks.
 const (
-	EventPush       = "push"
-	EventPull       = "pull_request"
-	EventPullClosed = "pull_request_closed"
-	EventTag        = "tag"
-	EventRelease    = "release"
-	EventDeploy     = "deployment"
-	EventCron       = "cron"
-	EventManual     = "manual"
+	EventPush         = "push"
+	EventPull         = "pull_request"
+	EventPullClosed   = "pull_request_closed"
+	EventPullMetadata = "pull_request_metadata"
+	EventTag          = "tag"
+	EventRelease      = "release"
+	EventDeploy       = "deployment"
+	EventCron         = "cron"
+	EventManual       = "manual"
 )
 
+func EventIsPull(event string) bool {
+	switch event {
+	case EventPull,
+		EventPullClosed,
+		EventPullMetadata:
+		return true
+	}
+	return false
+}
+
 // Different ways to handle failure states.
 const (
 	FailureIgnore = "ignore"

diff --git a/pipeline/frontend/metadata/environment.go b/pipeline/frontend/metadata/environment.go
@@ -68,6 +68,7 @@ func (m *Metadata) Environ() map[string]string {
 	setNonEmptyEnvVar(params, "CI_PIPELINE_NUMBER", strconv.FormatInt(pipeline.Number, 10))
 	setNonEmptyEnvVar(params, "CI_PIPELINE_PARENT", strconv.FormatInt(pipeline.Parent, 10))
 	setNonEmptyEnvVar(params, "CI_PIPELINE_EVENT", pipeline.Event)
+	setNonEmptyEnvVar(params, "CI_PIPELINE_EVENT_REASON", strings.Join(pipeline.EventReason, ","))
 	setNonEmptyEnvVar(params, "CI_PIPELINE_URL", m.getPipelineWebURL(pipeline, 0))
 	setNonEmptyEnvVar(params, "CI_PIPELINE_FORGE_URL", pipeline.ForgeURL)
 	setNonEmptyEnvVar(params, "CI_PIPELINE_DEPLOY_TARGET", pipeline.DeployTo)
@@ -102,7 +103,7 @@ func (m *Metadata) Environ() map[string]string {
 	if pipeline.Event == EventRelease {
 		setNonEmptyEnvVar(params, "CI_COMMIT_PRERELEASE", strconv.FormatBool(pipeline.Commit.IsPrerelease))
 	}
-	if pipeline.Event == EventPull || pipeline.Event == EventPullClosed {
+	if EventIsPull(pipeline.Event) {
 		sourceBranch, targetBranch := getSourceTargetBranches(commit.Refspec)
 		setNonEmptyEnvVar(params, "CI_COMMIT_SOURCE_BRANCH", sourceBranch)
 		setNonEmptyEnvVar(params, "CI_COMMIT_TARGET_BRANCH", targetBranch)
@@ -128,6 +129,7 @@ func (m *Metadata) Environ() map[string]string {
 	setNonEmptyEnvVar(params, "CI_PREV_PIPELINE_NUMBER", strconv.FormatInt(prevPipeline.Number, 10))
 	setNonEmptyEnvVar(params, "CI_PREV_PIPELINE_PARENT", strconv.FormatInt(prevPipeline.Parent, 10))
 	setNonEmptyEnvVar(params, "CI_PREV_PIPELINE_EVENT", prevPipeline.Event)
+	setNonEmptyEnvVar(params, "CI_PREV_PIPELINE_EVENT_REASON", strings.Join(prevPipeline.EventReason, ","))
 	setNonEmptyEnvVar(params, "CI_PREV_PIPELINE_URL", m.getPipelineWebURL(prevPipeline, 0))
 	setNonEmptyEnvVar(params, "CI_PREV_PIPELINE_FORGE_URL", prevPipeline.ForgeURL)
 	setNonEmptyEnvVar(params, "CI_PREV_COMMIT_URL", prevPipeline.ForgeURL) // why commit url?
@@ -149,7 +151,7 @@ func (m *Metadata) Environ() map[string]string {
 	setNonEmptyEnvVar(params, "CI_PREV_COMMIT_AUTHOR", prevCommit.Author.Name)
 	setNonEmptyEnvVar(params, "CI_PREV_COMMIT_AUTHOR_EMAIL", prevCommit.Author.Email)
 	setNonEmptyEnvVar(params, "CI_PREV_COMMIT_AUTHOR_AVATAR", prevCommit.Author.Avatar)
-	if prevPipeline.Event == EventPull || prevPipeline.Event == EventPullClosed {
+	if EventIsPull(prevPipeline.Event) {
 		prevSourceBranch, prevTargetBranch := getSourceTargetBranches(prevCommit.Refspec)
 		setNonEmptyEnvVar(params, "CI_PREV_COMMIT_SOURCE_BRANCH", prevSourceBranch)
 		setNonEmptyEnvVar(params, "CI_PREV_COMMIT_TARGET_BRANCH", prevTargetBranch)

diff --git a/pipeline/frontend/metadata/types.go b/pipeline/frontend/metadata/types.go
@@ -43,20 +43,21 @@ type (
 
 	// Pipeline defines runtime metadata for a pipeline.
 	Pipeline struct {
-		Number     int64  `json:"number,omitempty"`
-		Created    int64  `json:"created,omitempty"`
-		Started    int64  `json:"started,omitempty"`
-		Finished   int64  `json:"finished,omitempty"`
-		Status     string `json:"status,omitempty"`
-		Event      string `json:"event,omitempty"`
-		ForgeURL   string `json:"forge_url,omitempty"`
-		DeployTo   string `json:"target,omitempty"`
-		DeployTask string `json:"task,omitempty"`
-		Commit     Commit `json:"commit,omitempty"`
-		Parent     int64  `json:"parent,omitempty"`
-		Cron       string `json:"cron,omitempty"`
-		Author     string `json:"author,omitempty"`
-		Avatar     string `json:"avatar,omitempty"`
+		Number      int64    `json:"number,omitempty"`
+		Created     int64    `json:"created,omitempty"`
+		Started     int64    `json:"started,omitempty"`
+		Finished    int64    `json:"finished,omitempty"`
+		Status      string   `json:"status,omitempty"`
+		Event       string   `json:"event,omitempty"`
+		EventReason []string `json:"event_reason,omitempty"`
+		ForgeURL    string   `json:"forge_url,omitempty"`
+		DeployTo    string   `json:"target,omitempty"`
+		DeployTask  string   `json:"task,omitempty"`
+		Commit      Commit   `json:"commit,omitempty"`
+		Parent      int64    `json:"parent,omitempty"`
+		Cron        string   `json:"cron,omitempty"`
+		Author      string   `json:"author,omitempty"`
+		Avatar      string   `json:"avatar,omitempty"`
 	}
 
 	// Commit defines runtime metadata for a commit.

diff --git a/pipeline/frontend/yaml/compiler/compiler.go b/pipeline/frontend/yaml/compiler/compiler.go
@@ -70,8 +70,8 @@ func (s *Secret) Match(event string) bool {
 		return true
 	}
 	// treat all pull events the same way
-	if event == "pull_request_closed" {
-		event = "pull_request"
+	if metadata.EventIsPull(event) {
+		event = metadata.EventPull
 	}
 	// one match is enough
 	return slices.Contains(s.Events, event)

diff --git a/pipeline/frontend/yaml/compiler/compiler_test.go b/pipeline/frontend/yaml/compiler/compiler_test.go
@@ -467,6 +467,12 @@ func TestSecretMatch(t *testing.T) {
 			event:  "pull_request_closed",
 			match:  true,
 		},
+		{
+			name:   "pull metadata change should match pull",
+			secret: Secret{Events: []string{"pull_request"}},
+			event:  "pull_request_metadata",
+			match:  true,
+		},
 	}
 
 	for _, tc := range tcl {

diff --git a/pipeline/frontend/yaml/constraint/constraint.go b/pipeline/frontend/yaml/constraint/constraint.go
@@ -169,7 +169,7 @@ func (c *Constraint) Match(m metadata.Metadata, global bool, env map[string]stri
 		c.Instance.Match(m.Sys.Host)
 
 	// changed files filter apply only for pull-request and push events
-	if m.Curr.Event == metadata.EventPull || m.Curr.Event == metadata.EventPullClosed || m.Curr.Event == metadata.EventPush {
+	if metadata.EventIsPull(m.Curr.Event) || m.Curr.Event == metadata.EventPush {
 		match = match && c.Path.Match(m.Curr.Commit.ChangedFiles, m.Curr.Commit.Message)
 	}
 

diff --git a/pipeline/frontend/yaml/linter/schema/.woodpecker/test-pipeline-when.yaml b/pipeline/frontend/yaml/linter/schema/.woodpecker/test-pipeline-when.yaml
@@ -13,6 +13,9 @@ when:
   - event:
       exclude: pull_request_closed
     evaluate: 'CI_COMMIT_AUTHOR == "woodpecker-ci"'
+  - event:
+      exclude: pull_request_metadata
+    evaluate: 'CI_COMMIT_AUTHOR == "woodpecker-ci"'
 
 steps:
   echo:

diff --git a/pipeline/frontend/yaml/linter/schema/.woodpecker/test-when.yaml b/pipeline/frontend/yaml/linter/schema/.woodpecker/test-when.yaml
@@ -33,6 +33,7 @@ steps:
         - push
         - pull_request
         - pull_request_closed
+        - pull_request_metadata
         - tag
         - deployment
         - release

diff --git a/pipeline/frontend/yaml/linter/schema/schema.json b/pipeline/frontend/yaml/linter/schema/schema.json
@@ -503,7 +503,17 @@
       }
     },
     "event_enum": {
-      "enum": ["push", "pull_request", "pull_request_closed", "tag", "deployment", "cron", "manual", "release"]
+      "enum": [
+        "push",
+        "pull_request",
+        "pull_request_closed",
+        "pull_request_metadata",
+        "tag",
+        "deployment",
+        "cron",
+        "manual",
+        "release"
+      ]
     },
     "event_constraint_list": {
       "oneOf": [

diff --git a/server/api/hook.go b/server/api/hook.go
@@ -327,7 +327,7 @@ func PostHook(c *gin.Context) {
 	// 5. Check if pull requests are allowed for this repo
 	//
 
-	if (pipelineFromForge.Event == model.EventPull || pipelineFromForge.Event == model.EventPullClosed) && !repo.AllowPull {
+	if pipelineFromForge.IsPullRequest() && !repo.AllowPull {
 		log.Debug().Str("repo", repo.FullName).Msg("ignoring hook: pull requests are disabled for this repo in woodpecker")
 		c.Status(http.StatusNoContent)
 		return

diff --git a/server/forge/common/event_normalize.go b/server/forge/common/event_normalize.go
@@ -0,0 +1,13 @@
+package common
+
+func NormalizeEventReason(in string) string {
+	switch in {
+	case "labels_cleared":
+		return "label_cleared"
+	case "labels_updated":
+		return "label_updated"
+	case "labels_added":
+		return "label_added"
+	}
+	return in
+}