From 33d16615306cad3cb75c19a4bf713fab680ae0b5 Mon Sep 17 00:00:00 2001
From: Andras Bacsai <5845193+andrasbacsai@users.noreply.github.com>
Date: Tue, 2 Dec 2025 13:11:15 +0100
Subject: [PATCH] Improve Advanced Settings helper texts for clarity
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- API Access: Explain what REST API access enables and where to configure tokens
- Registration Allowed: Simplify wording while keeping both states clear
- Do Not Track: Clarify it only tracks instance count to coolify.io
- DNS Validation: Explain the benefit (prevents deployment failures)
- Custom DNS Servers: Add example format and note about system defaults
- Sponsorship Popup: Make purpose and action clearer, less verbose

These improvements provide users with meaningful, actionable information instead of redundant or vague descriptions.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 resources/views/livewire/settings/advanced.blade.php | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/resources/views/livewire/settings/advanced.blade.php b/resources/views/livewire/settings/advanced.blade.php
index c47c2cfef..7d714a409 100644
--- a/resources/views/livewire/settings/advanced.blade.php
+++ b/resources/views/livewire/settings/advanced.blade.php
@@ -18,28 +18,28 @@ class="flex flex-col h-full gap-8 sm:flex-row">
                 <div class="flex flex-col gap-1">
                     <div class="md:w-96">
                         <x-forms.checkbox instantSave id="is_registration_enabled"
-                            helper="If enabled, users can register themselves. If disabled, only administrators can create new users."
+                            helper="Allow users to self-register. If disabled, only administrators can create accounts."
                             label="Registration Allowed" />
                     </div>
                     <div class="md:w-96">
                         <x-forms.checkbox instantSave id="do_not_track"
-                            helper="If enabled, Coolify will not track any data. This is useful if you are concerned about privacy."
+                            helper="Opt out of reporting this instance to coolify.io's installation count. No other data is collected."
                             label="Do Not Track" />
                     </div>
                     <h4 class="pt-4">DNS Settings</h4>
                     <div class="md:w-96">
                         <x-forms.checkbox instantSave id="is_dns_validation_enabled"
-                            helper="If you set a custom domain, Coolify will validate the domain in your DNS provider."
+                            helper="Verify that custom domains are correctly configured in DNS before deployment. Prevents deployment failures from DNS misconfigurations."
                             label="DNS Validation" />
                     </div>
 
                     <x-forms.input id="custom_dns_servers" label="Custom DNS Servers"
-                        helper="DNS servers to validate domains against. A comma separated list of DNS servers."
+                        helper="Custom DNS servers for domain validation. Comma-separated list (e.g., 1.1.1.1,8.8.8.8). Leave empty to use system defaults."
                         placeholder="1.1.1.1,8.8.8.8" />
                     <h4 class="pt-4">API Settings</h4>
                     <div class="md:w-96">
                         <x-forms.checkbox instantSave id="is_api_enabled" label="API Access"
-                            helper="If enabled, the API will be enabled. If disabled, the API will be disabled." />
+                            helper="If enabled, authenticated requests to Coolify's REST API will be allowed. Configure API tokens in Security > API Tokens." />
                     </div>
                     <x-forms.input id="allowed_ips" label="Allowed IPs for API Access"
                         helper="Allowed IP addresses or subnets for API access.<br>Supports single IPs (192.168.1.100) and CIDR notation (192.168.1.0/24).<br>Use comma to separate multiple entries.<br>Use 0.0.0.0 or leave empty to allow from anywhere."
@@ -53,7 +53,7 @@ class="flex flex-col h-full gap-8 sm:flex-row">
                     <h4 class="pt-4">Confirmation Settings</h4>
                     <div class="md:w-96">
                         <x-forms.checkbox instantSave id=" is_sponsorship_popup_enabled" label="Show Sponsorship Popup"
-                            helper="When enabled, sponsorship popups will be shown monthly to users. When disabled, the sponsorship popup will be permanently hidden for all users." />
+                            helper="Show monthly sponsorship reminders to support Coolify development. Disable to hide these messages permanently." />
                     </div>
                 </div>
                 <div class="flex flex-col gap-1">