diff --git a/developer_manual/basics/events.rst b/developer_manual/basics/events.rst
index 1b5c0dcde64..f97c2e71444 100644
--- a/developer_manual/basics/events.rst
+++ b/developer_manual/basics/events.rst
@@ -425,6 +425,16 @@ Emitted when the authentication fails, but only if the login name can be associa
 
 .. versionadded:: 20
 
+``\OCP\Collaboration\Reference\RenderReferenceEvent``
+*****************************************************
+
+.. versionadded:: 25
+
+Event emitted when apps might render references like link previews or smart picker widgets.
+
+This can be used to inject scripts for extending that. Further details can be found in the 
+:ref:`Reference providers` deep dive.
+
 ``\OCP\Contacts\Events\ContactInteractedWithEvent``
 ***************************************************
 
@@ -542,6 +552,13 @@ Deprecated in 20.0.0 - it can't be guaranteed that this event is triggered in al
 
 Emitted before a system mail is sent. It can be used to alter the message.
 
+``OCP\Preview\BeforePreviewFetchedEvent``
+*****************************************
+
+.. versionadded:: 26
+
+Emitted before a file preview is being fetched. It can be used to block preview rendering by throwing a ``OCP\Files\NotFoundException``.
+
 ``\OCP\Security\CSP\AddContentSecurityPolicyEvent``
 ***************************************************
 
diff --git a/developer_manual/digging_deeper/reference.rst b/developer_manual/digging_deeper/reference.rst
index 01912648b76..875a70e5820 100644
--- a/developer_manual/digging_deeper/reference.rst
+++ b/developer_manual/digging_deeper/reference.rst
@@ -1,3 +1,5 @@
+.. _Reference providers:
+
 ===================
 Reference providers
 ===================