diff --git a/changelog.d/1016.doc b/changelog.d/1016.doc
new file mode 100644
index 00000000..120b4f23
--- /dev/null
+++ b/changelog.d/1016.doc
@@ -0,0 +1 @@
+Explain how to edit room state for GitLab projects from within Element.
diff --git a/docs/usage/room_configuration/gitlab_project.md b/docs/usage/room_configuration/gitlab_project.md
index 92d678ce..23e69b26 100644
--- a/docs/usage/room_configuration/gitlab_project.md
+++ b/docs/usage/room_configuration/gitlab_project.md
@@ -19,7 +19,7 @@ To set up a connection to a GitLab project in a new room:
 
 ## Configuration
 
-This connection supports a few options which can be defined in the room state:
+This connection supports a few options which can be defined in the room state[^2]:
 
 | Option | Description | Allowed values | Default |
 |--------|-------------|----------------|---------|
@@ -34,6 +34,8 @@ This connection supports a few options which can be defined in the room state:
 
 [^1]: `ignoreHooks` is no longer accepted for new state events. Use `enableHooks` to explicitly state all events you want to see.
 
+[^2]: To change room state with Element Web/Desktop: open devtools by typing `/devtools` + enter in the chat box, and click on "Explore room state". Next, choose `uk.half-shot.matrix-hookshot.gitlab.repository`. You'll then be able to see and edit (if you have the required permissions) the settings by setting properties on the JSON object directly.
+
 
 ### Supported event types