From a0fee37f6458256d91063f016e5b209cacfabd14 Mon Sep 17 00:00:00 2001
From: Shalini-Ashokan <102292178+Shalini-Ashokan@users.noreply.github.com>
Date: Fri, 27 Mar 2026 19:47:40 +0530
Subject: [PATCH] Fixed the label gradient background fix issue.

---
 src/Core/src/Handlers/Label/LabelHandler.iOS.cs | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/src/Core/src/Handlers/Label/LabelHandler.iOS.cs b/src/Core/src/Handlers/Label/LabelHandler.iOS.cs
index 4f7a01e99405..0f0bc77a3cba 100644
--- a/src/Core/src/Handlers/Label/LabelHandler.iOS.cs
+++ b/src/Core/src/Handlers/Label/LabelHandler.iOS.cs
@@ -17,7 +17,15 @@ public static void MapBackground(ILabelHandler handler, ILabel label)
 		{
 			handler.UpdateValue(nameof(IViewHandler.ContainerView));
 
-			handler.PlatformView?.UpdateBackground(label);
+			// Gradient sublayers cover UILabel text, so route them to WrapperView; solid colors stay on PlatformView for correct Clip masking.
+			if (label.Background is GradientPaint)
+			{
+				handler.ToPlatform()?.UpdateBackground(label);
+			}
+			else
+			{
+				handler.PlatformView?.UpdateBackground(label);
+			}
 		}
 
 		public static void MapText(ILabelHandler handler, ILabel label)