diff --git a/doc/maintaining/authorization.rst b/doc/maintaining/authorization.rst
index acf9adf0265..342eec63b0c 100644
--- a/doc/maintaining/authorization.rst
+++ b/doc/maintaining/authorization.rst
@@ -86,5 +86,14 @@ Extensions
 
 CKAN extensions can implement custom authorization rules by overriding the
 authorization functions that CKAN uses. This is done by implementing the
-:py:class:`~ckan.plugins.interfaces.IAuthFunctions` plugin interface. To get
-started with writing CKAN extensions, see :doc:`/extensions/index`.
+:py:class:`~ckan.plugins.interfaces.IAuthFunctions` plugin interface.
+
+Dataset visibility is determined by permission labels stored in the
+search index.
+Implement the :py:class:`~ckan.plugins.interfaces.IPermissionLabels`
+plugin interface then :ref:`rebuild your search index <rebuild search index>`
+to change your dataset visibility rules. There is no
+no need to override the ``package_show`` auth function, it will inherit
+these changes automatically.
+
+To get started with writing CKAN extensions, see :doc:`/extensions/index`.