auth0 · ramya18101 · Nov 6, 2025 · Oct 18, 2025 · Oct 22, 2025 · Oct 22, 2025
diff --git a/docs/auth0_universal-login.md b/docs/auth0_universal-login.md
@@ -5,13 +5,23 @@ has_children: true
 ---
 # auth0 universal-login
 
-Manage a consistent, branded Universal Login experience that can handle all of your authentication flows.
+Manage Universal Login branding and customization settings.
+
+� DEPRECATION WARNING: Advanced Customizations (ACUL) have moved!
+
+The 'auth0 ul customize --rendering-mode advanced' functionality will be 
+DEPRECATED on April 18, 2026. Please migrate to the new ACUL commands:
+
+  ✅ auth0 acul config generate|get|set|list|docs
+
+Standard Universal Login customizations continue to work as before.
 
 ## Commands
 
-- [auth0 universal-login customize](auth0_universal-login_customize.md) - Customize the Universal Login experience
+- [auth0 universal-login customize](auth0_universal-login_customize.md) - ⚠️ Customize Universal Login (Advanced mode DEPRECATED)
 - [auth0 universal-login prompts](auth0_universal-login_prompts.md) - Manage custom text for prompts
 - [auth0 universal-login show](auth0_universal-login_show.md) - Display the custom branding settings for Universal Login
+- [auth0 universal-login switch](auth0_universal-login_switch.md) - ⚠️ Switch rendering mode (DEPRECATED)
 - [auth0 universal-login templates](auth0_universal-login_templates.md) - Manage custom Universal Login templates
 - [auth0 universal-login update](auth0_universal-login_update.md) - Update the custom branding settings for Universal Login
 
diff --git a/docs/auth0_universal-login_customize.md b/docs/auth0_universal-login_customize.md
@@ -5,7 +5,21 @@ has_toc: false
 ---
 # auth0 universal-login customize
 
-Customize and preview changes to the Universal Login experience. This command will open a webpage within your browser where you can edit and preview your branding changes. For a comprehensive list of editable parameters and their values please visit the [Management API Documentation](https://auth0.com/docs/api/management/v2).
+
+Customize your Universal Login Experience. Note that this requires a custom domain to be configured for the tenant. 
+
+* Standard mode is recommended for creating a consistent, branded experience for users. Choosing Standard mode will open a webpage
+within your browser where you can edit and preview your branding changes.For a comprehensive list of editable parameters and their values,
+please visit the [Management API Documentation](https://auth0.com/docs/api/management/v2)
+
+⚠️  DEPRECATION NOTICE: Advanced mode will be deprecated on 2026-04-30
+   For future Advanced Customizations, use: auth0 acul config <command>
+* Advanced mode is recommended for full customization/granular control of the login experience and to integrate your own component design system. 
+Choosing Advanced mode will open the default terminal editor, with the rendering configs:
+
+![storybook](settings.json)
+
+Closing the terminal editor will save the settings to your tenant.
 
 ## Usage
 ```
@@ -20,6 +34,16 @@ auth0 universal-login customize [flags]
 ```
 
 
+## Flags
+
+```
+  -f, --file string             File to save the rendering configs to.
+  -p, --prompt string           Name of the prompt to to switch or customize.
+  -r, --rendering-mode string   standardMode is recommended for customizating consistent, branded experience for users.
+                                Alternatively, advancedMode is recommended for full customization/granular control of the login experience and to integrate own component design system
+
+  -s, --screen string           Name of the screen to customize.
+```
 
 
 ## Inherited Flags
@@ -34,9 +58,10 @@ auth0 universal-login customize [flags]
 
 ## Related Commands
 
-- [auth0 universal-login customize](auth0_universal-login_customize.md) - Customize the Universal Login experience
+- [auth0 universal-login customize](auth0_universal-login_customize.md) - ⚠️ Customize Universal Login (Advanced mode DEPRECATED)
 - [auth0 universal-login prompts](auth0_universal-login_prompts.md) - Manage custom text for prompts
 - [auth0 universal-login show](auth0_universal-login_show.md) - Display the custom branding settings for Universal Login
+- [auth0 universal-login switch](auth0_universal-login_switch.md) - ⚠️ Switch rendering mode (DEPRECATED)
 - [auth0 universal-login templates](auth0_universal-login_templates.md) - Manage custom Universal Login templates
 - [auth0 universal-login update](auth0_universal-login_update.md) - Update the custom branding settings for Universal Login
 

diff --git a/docs/auth0_universal-login_show.md b/docs/auth0_universal-login_show.md
@@ -42,9 +42,10 @@ auth0 universal-login show [flags]
 
 ## Related Commands
 
-- [auth0 universal-login customize](auth0_universal-login_customize.md) - Customize the Universal Login experience
+- [auth0 universal-login customize](auth0_universal-login_customize.md) - ⚠️ Customize Universal Login (Advanced mode DEPRECATED)
 - [auth0 universal-login prompts](auth0_universal-login_prompts.md) - Manage custom text for prompts
 - [auth0 universal-login show](auth0_universal-login_show.md) - Display the custom branding settings for Universal Login
+- [auth0 universal-login switch](auth0_universal-login_switch.md) - ⚠️ Switch rendering mode (DEPRECATED)
 - [auth0 universal-login templates](auth0_universal-login_templates.md) - Manage custom Universal Login templates
 - [auth0 universal-login update](auth0_universal-login_update.md) - Update the custom branding settings for Universal Login
 

diff --git a/docs/auth0_universal-login_switch.md b/docs/auth0_universal-login_switch.md
@@ -0,0 +1,63 @@
+---
+layout: default
+parent: auth0 universal-login
+has_toc: false
+---
+# auth0 universal-login switch
+
+Switch the rendering mode for Universal Login. Note that this requires a custom domain to be configured for the tenant.
+
+🚨 DEPRECATION WARNING: The 'auth0 ul switch' command will be DEPRECATED on April 30, 2026
+
+✅ For Advanced Customizations, migrate to the new ACUL config commands:
+  • auth0 acul config generate <screen>
+  • auth0 acul config get <screen>  
+  • auth0 acul config set <screen>
+  • auth0 acul config list
+
+## Usage
+```
+auth0 universal-login switch [flags]
+```
+
+## Examples
+
+```
+  auth0 universal-login switch
+  auth0 universal-login switch --prompt login-id --screen login-id --rendering-mode standard
+  auth0 ul switch --prompt login-id --screen login-id --rendering-mode advanced
+  auth0 ul switch -p login-id -s login-id -r standard
+```
+
+
+## Flags
+
+```
+  -p, --prompt string           Name of the prompt to to switch or customize.
+  -r, --rendering-mode string   standardMode is recommended for customizating consistent, branded experience for users.
+                                Alternatively, advancedMode is recommended for full customization/granular control of the login experience and to integrate own component design system
+
+  -s, --screen string           Name of the screen to customize.
+```
+
+
+## Inherited Flags
+
+```
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 universal-login customize](auth0_universal-login_customize.md) - ⚠️ Customize Universal Login (Advanced mode DEPRECATED)
+- [auth0 universal-login prompts](auth0_universal-login_prompts.md) - Manage custom text for prompts
+- [auth0 universal-login show](auth0_universal-login_show.md) - Display the custom branding settings for Universal Login
+- [auth0 universal-login switch](auth0_universal-login_switch.md) - ⚠️ Switch rendering mode (DEPRECATED)
+- [auth0 universal-login templates](auth0_universal-login_templates.md) - Manage custom Universal Login templates
+- [auth0 universal-login update](auth0_universal-login_update.md) - Update the custom branding settings for Universal Login
+
+
diff --git a/docs/auth0_universal-login_update.md b/docs/auth0_universal-login_update.md
@@ -52,9 +52,10 @@ auth0 universal-login update [flags]
 
 ## Related Commands
 
-- [auth0 universal-login customize](auth0_universal-login_customize.md) - Customize the Universal Login experience
+- [auth0 universal-login customize](auth0_universal-login_customize.md) - ⚠️ Customize Universal Login (Advanced mode DEPRECATED)
 - [auth0 universal-login prompts](auth0_universal-login_prompts.md) - Manage custom text for prompts
 - [auth0 universal-login show](auth0_universal-login_show.md) - Display the custom branding settings for Universal Login
+- [auth0 universal-login switch](auth0_universal-login_switch.md) - ⚠️ Switch rendering mode (DEPRECATED)
 - [auth0 universal-login templates](auth0_universal-login_templates.md) - Manage custom Universal Login templates
 - [auth0 universal-login update](auth0_universal-login_update.md) - Update the custom branding settings for Universal Login
 

diff --git a/internal/cli/universal_login.go b/internal/cli/universal_login.go
@@ -56,14 +56,23 @@ func universalLoginCmd(cli *cli) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "universal-login",
 		Short: "Manage the Universal Login experience",
-		Long: "Manage a consistent, branded Universal Login experience that can " +
-			"handle all of your authentication flows.",
+		Long: `Manage Universal Login branding and customization settings.
+
+� DEPRECATION WARNING: Advanced Customizations (ACUL) have moved!
+
+The 'auth0 ul customize --rendering-mode advanced' functionality will be 
+DEPRECATED on April 18, 2026. Please migrate to the new ACUL commands:
+
+  ✅ auth0 acul config generate|get|set|list|docs
+
+Standard Universal Login customizations continue to work as before.`,
 		Aliases: []string{"ul"},
 	}
 
 	cmd.SetUsageTemplate(resourceUsageTemplate())
 
 	cmd.AddCommand(customizeUniversalLoginCmd(cli))
+	cmd.AddCommand(switchUniversalLoginRendererModeCmd(cli))
 	cmd.AddCommand(showUniversalLoginCmd(cli))
 	cmd.AddCommand(updateUniversalLoginCmd(cli))
 	cmd.AddCommand(universalLoginTemplatesCmd(cli))