diff --git a/src/Microsoft.AspNetCore.Mvc.RazorPages/Filters/IAsyncPageFilter.cs b/src/Microsoft.AspNetCore.Mvc.RazorPages/Filters/IAsyncPageFilter.cs
index a4534e7dc2..1c6a0503df 100644
--- a/src/Microsoft.AspNetCore.Mvc.RazorPages/Filters/IAsyncPageFilter.cs
+++ b/src/Microsoft.AspNetCore.Mvc.RazorPages/Filters/IAsyncPageFilter.cs
@@ -6,7 +6,8 @@ using System.Threading.Tasks;
namespace Microsoft.AspNetCore.Mvc.Filters
{
///
- /// A filter that asynchronously surrounds execution of the page handler method.
+ /// A filter that asynchronously surrounds execution of a page handler method. This filter is executed only when
+ /// decorated on a handler's type and not on individual handler methods.
///
public interface IAsyncPageFilter : IFilterMetadata
{
diff --git a/src/Microsoft.AspNetCore.Mvc.RazorPages/Filters/IPageFilter.cs b/src/Microsoft.AspNetCore.Mvc.RazorPages/Filters/IPageFilter.cs
index 101317c94f..6fde59efb1 100644
--- a/src/Microsoft.AspNetCore.Mvc.RazorPages/Filters/IPageFilter.cs
+++ b/src/Microsoft.AspNetCore.Mvc.RazorPages/Filters/IPageFilter.cs
@@ -4,7 +4,8 @@
namespace Microsoft.AspNetCore.Mvc.Filters
{
///
- /// A filter that surrounds execution of a page handler method.
+ /// A filter that surrounds execution of a page handler method. This filter is executed only when decorated on a
+ /// handler's type and not on individual handler methods.
///
public interface IPageFilter : IFilterMetadata
{
@@ -21,7 +22,7 @@ namespace Microsoft.AspNetCore.Mvc.Filters
void OnPageHandlerExecuting(PageHandlerExecutingContext context);
///
- /// Called after the handler method executes, before the action method is invoked.
+ /// Called after the handler method executes, before the action result executes.
///
/// The .
void OnPageHandlerExecuted(PageHandlerExecutedContext context);
diff --git a/src/Microsoft.AspNetCore.Mvc.RazorPages/PageModel.cs b/src/Microsoft.AspNetCore.Mvc.RazorPages/PageModel.cs
index ba9062bfe3..ce5a76af27 100644
--- a/src/Microsoft.AspNetCore.Mvc.RazorPages/PageModel.cs
+++ b/src/Microsoft.AspNetCore.Mvc.RazorPages/PageModel.cs
@@ -1675,7 +1675,7 @@ namespace Microsoft.AspNetCore.Mvc.RazorPages
}
///
- /// Called after the handler method executes, before the action method is invoked.
+ /// Called after the handler method executes, before the action result executes.
///
/// The .
public virtual void OnPageHandlerExecuted(PageHandlerExecutedContext context)