From e1c23c76557c1bad82005f61effb685fba775c6c Mon Sep 17 00:00:00 2001
From: Nate Wiebe <nate@symetricproductions.com>
Date: Thu, 2 Jan 2025 10:20:16 -0500
Subject: [PATCH] Add docs for is_granted_for_user() function

---
 reference/twig_reference.rst | 21 +++++++++++++++++++++
 security.rst                 | 11 +++++++++++
 2 files changed, 32 insertions(+)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index d8b802dd73e..4485494bd9c 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -174,6 +174,27 @@ Returns ``true`` if the current user has the given role.
 Optionally, an object can be passed to be used by the voter. More information
 can be found in :ref:`security-template`.
 
+is_granted_for_user
+~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: twig
+
+    {{ is_granted_for_user(user, attribute, subject = null, field = null) }}
+
+``user``
+    **type**: ``object``
+``attribute``
+    **type**: ``string``
+``subject`` *(optional)*
+    **type**: ``object``
+``field`` *(optional)*
+    **type**: ``string``
+
+Returns ``true`` if the user is authorized for the specified attribute.
+
+Optionally, an object can be passed to be used by the voter. More information
+can be found in :ref:`security-template`.
+
 logout_path
 ~~~~~~~~~~~
 
diff --git a/security.rst b/security.rst
index 8026c63484b..7fe452e4fae 100644
--- a/security.rst
+++ b/security.rst
@@ -2549,6 +2549,17 @@ the built-in ``is_granted()`` helper function in any Twig template:
 
 .. _security-isgranted:
 
+Similarly, if you want to check if a specific user has a certain role, you can use
+the built-in ``is_granted_for_user()`` helper function:
+
+.. code-block:: html+twig
+
+    {% if is_granted_for_user(user, 'ROLE_ADMIN') %}
+        <a href="...">Delete</a>
+    {% endif %}
+
+.. _security-isgrantedforuser:
+
 Securing other Services
 .......................