diff --git a/README.md b/README.md
index 2b8ba58e..7f99e1b2 100644
--- a/README.md
+++ b/README.md
@@ -214,3 +214,7 @@ If you are coming from [jtarchie/github-pullrequest-resource][original-resource]
 - `put`:
   - `merge.*`
   - `label`
+
+Note that if you are migrating from the original resource on a Concourse version prior to `v5.0.0`, you might
+see an error `failed to unmarshal request: json: unknown field "ref"`. The solution is to rename the resource
+so that the history is wiped. See [#64](https://github.com/telia-oss/github-pr-resource/issues/64) for details.