🧩 Custom Code Settings
LucentUI allows you to inject custom code into multiple areas of your site, giving full control without editing the core theme.
Custom HTML - Head
- Setting Name:
custom_head_html
- Type: Textarea
- Description: Injects inside
<head>. Ideal for:
- Google Analytics
- Custom fonts
- Meta tags
Examples:
Google Analytics 4:
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'GA_MEASUREMENT_ID');
</script>
Custom Fonts:
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
Meta Tags for SEO:
<meta name="theme-color" content="#000000">
<meta name="author" content="Your Name">
<meta property="og:site_name" content="Your Site Name">
Custom HTML - Body Top
- Setting Name:
custom_body_top_html
- Type: Textarea
- Description: Injects at top of
<body>. Common uses:
- Google Tag Manager (noscript)
- Tracking pixels
Examples:
Google Tag Manager (noscript):
<!-- Google Tag Manager (noscript) -->
<noscript>
<iframe src="https://www.googletagmanager.com/ns.html?id=GTM-XXXXXXX"
height="0" width="0" style="display:none;visibility:hidden">
</iframe>
</noscript>
Facebook Pixel:
<noscript>
<img height="1" width="1" style="display:none"
src="https://www.facebook.com/tr?id=YOUR_PIXEL_ID&ev=PageView&noscript=1"/>
</noscript>
Custom HTML - Body Bottom
- Setting Name:
custom_body_bottom_html
- Type: Textarea
- Description: Injects before
</body>. Use for:
- Chat widgets (e.g. Tawk.to, Crisp)
- Discord embeds
- Support widgets
Examples:
Tawk.to Chat Widget:
<!--Start of Tawk.to Script-->
<script type="text/javascript">
var Tawk_API=Tawk_API||{}, Tawk_LoadStart=new Date();
(function(){
var s1=document.createElement("script"),s0=document.getElementsByTagName("script")[0];
s1.async=true;
s1.src='https://embed.tawk.to/YOUR_WIDGET_ID/default';
s1.charset='UTF-8';
s1.setAttribute('crossorigin','*');
s0.parentNode.insertBefore(s1,s0);
})();
</script>
<!--End of Tawk.to Script-->
Crisp Chat:
<script type="text/javascript">
window.$crisp=[];
window.CRISP_WEBSITE_ID="YOUR-WEBSITE-ID";
(function(){
d=document;
s=d.createElement("script");
s.src="https://client.crisp.chat/l.js";
s.async=1;
d.getElementsByTagName("head")[0].appendChild(s);
})();
</script>
Discord Widget:
<iframe src="https://discord.com/widget?id=YOUR_SERVER_ID&theme=dark"
width="350" height="500" allowtransparency="true"
frameborder="0" sandbox="allow-popups allow-popups-to-escape-sandbox allow-same-origin allow-scripts">
</iframe>
Custom HTML - Dashboard Only
- Setting Name:
custom_dashboard_html
- Type: Textarea
- Description: Displays only on dashboard pages. Great for:
- User-specific banners
- Admin announcements
Examples:
Admin Announcement Banner:
<div style="background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
color: white; padding: 1rem; margin: 1rem 0; border-radius: 8px; text-align: center;">
<h3 style="margin: 0 0 0.5rem 0;">🎉 New Feature Available!</h3>
<p style="margin: 0;">Check out our new dashboard analytics section.</p>
</div>
Maintenance Notice:
<div class="alert alert-warning" role="alert">
<strong>⚠️ Scheduled Maintenance:</strong>
System will be down for maintenance on March 15th from 2:00-4:00 AM EST.
</div>
Custom HTML - Homepage Only
- Setting Name:
custom_homepage_html
- Type: Textarea
- Description: Injects into homepage only. Use for:
- Promo banners
- Hero messages
Examples:
Promotional Banner:
<div style="background: linear-gradient(45deg, #ff6b6b, #feca57);
color: white; text-align: center; padding: 20px; margin: 20px 0; border-radius: 10px;">
<h2 style="margin: 0 0 10px 0;">🚀 50% Off All Plans!</h2>
<p style="margin: 0;">Limited time offer - Use code SAVE50 at checkout</p>
</div>
Newsletter Signup:
<div style="border: 2px solid #4CAF50; padding: 20px; margin: 20px 0; border-radius: 8px; text-align: center;">
<h3>📧 Stay Updated</h3>
<p>Subscribe to our newsletter for the latest updates!</p>
<input type="email" placeholder="Enter your email" style="padding: 10px; margin-right: 10px; border: 1px solid #ddd; border-radius: 4px;">
<button style="padding: 10px 20px; background: #4CAF50; color: white; border: none; border-radius: 4px;">Subscribe</button>
</div>
🎨 Custom CSS
- Setting Name:
custom_css
- Type: Textarea
- Description: Will be wrapped in
<style> tag.
Examples:
Dark Theme Customization:
:root {
--primary-color: #6366f1;
--background-dark: #0d1117;
--surface-dark: #161b22;
--text-primary: #f0f6fc;
--text-secondary: #8b949e;
}
body {
background-color: var(--background-dark);
color: var(--text-primary);
}
.card {
background-color: var(--surface-dark);
border: 1px solid #30363d;
border-radius: 12px;
box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
}
/* Custom scrollbar */
::-webkit-scrollbar {
width: 8px;
}
::-webkit-scrollbar-track {
background: var(--background-dark);
}
::-webkit-scrollbar-thumb {
background: var(--primary-color);
border-radius: 4px;
}
/* Smooth transitions */
* {
transition: all 0.2s ease-in-out;
}
/* Custom button styles */
.btn-primary {
background: linear-gradient(135deg, #6366f1 0%, #8b5cf6 100%);
border: none;
border-radius: 8px;
padding: 12px 24px;
font-weight: 500;
text-transform: uppercase;
letter-spacing: 0.5px;
}
.btn-primary:hover {
transform: translateY(-2px);
box-shadow: 0 8px 25px rgba(99, 102, 241, 0.3);
}
Responsive Design Enhancements:
/* Mobile-first responsive design */
@media (max-width: 768px) {
.container {
padding: 0 15px;
}
.hero-title {
font-size: 2rem;
}
.grid {
grid-template-columns: 1fr;
gap: 1rem;
}
}
@media (min-width: 769px) and (max-width: 1024px) {
.grid {
grid-template-columns: repeat(2, 1fr);
}
}
@media (min-width: 1025px) {
.grid {
grid-template-columns: repeat(3, 1fr);
}
}
/* Print styles */
@media print {
.no-print {
display: none !important;
}
}
🔧 Custom JavaScript
- Setting Name:
custom_js
- Type: Textarea
- Description: Injects at the bottom of the page inside
<script> tag.
Examples:
Enhanced User Experience:
// Welcome message with fade-in effect
document.addEventListener('DOMContentLoaded', function() {
console.log("Welcome to LucentUI!");
// Add fade-in animation to elements
const fadeElements = document.querySelectorAll('.fade-in');
fadeElements.forEach(element => {
element.style.opacity = '0';
element.style.transform = 'translateY(20px)';
element.style.transition = 'all 0.6s ease-out';
setTimeout(() => {
element.style.opacity = '1';
element.style.transform = 'translateY(0)';
}, 100);
});
});
Always test custom code in a staging environment before deploying to production. Consider performance impact and ensure compatibility across browsers.
Custom code is perfect for enhancing UI behavior, embedding third-party tools, or adding advanced analytics — all without touching the theme code.