diff --git a/src/user-guide/writing-workflows/configuration.rst b/src/user-guide/writing-workflows/configuration.rst
index 16bbf4a39a..832ce9ec07 100644
--- a/src/user-guide/writing-workflows/configuration.rst
+++ b/src/user-guide/writing-workflows/configuration.rst
@@ -153,8 +153,15 @@ show an inlined copy of the workflow with correct line numbers.
 ``cylc lint``
 ^^^^^^^^^^^^^
 
+.. seealso::
+
+   :ref:`How to configure Cylc lint at project level <lint.pyproject.toml>`
+   using a ``pyproject.toml``.
+
 .. automodule:: cylc.flow.scripts.lint
 
+.. _lint.pyproject.toml:
+
 Configure ``cylc lint`` at project level
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^