diff --git a/www/docs/ci/woodpecker.md b/www/docs/ci/woodpecker.md
new file mode 100644
index 00000000000..32b186b83e0
--- /dev/null
+++ b/www/docs/ci/woodpecker.md
@@ -0,0 +1,24 @@
+# Woodpecker
+
+By default, woodpecker only fetches tags on `tag` events. If you are not using a tag event, you will need to override the git plugin like so:
+
+```yaml
+clone:
+  git:
+    image: woodpeckerci/plugin-git
+    settings:
+      tags: true
+```
+
+Here is how to set up a basic release pipeline with [Woodpecker](https://woodpecker-ci.org) and [Gitea](https://gitea.io).
+
+```yaml
+pipeline:
+  release:
+    image: goreleaser/goreleaser
+    commands:
+      - goreleaser release
+    secrets: [ gitea_token ]
+    when:
+      event: tag
+```
diff --git a/www/mkdocs.yml b/www/mkdocs.yml
index c64516d0b3a..4c0abdf3cd2 100644
--- a/www/mkdocs.yml
+++ b/www/mkdocs.yml
@@ -70,6 +70,7 @@ nav:
   - ci/jenkins.md
   - ci/semaphore.md
   - ci/travis.md
+  - ci/woodpecker.md
 - Customization:
   - About: customization/index.md
   - Basics: