TenantCustomization model, allowing tenants to personalize their site with logos, hero images, and custom content.
Logo Management
Logo Field
The tenant logo is stored intenant_customization.logo_filename:
Logo Storage
Field:
Type:
Storage: File storage system (local or cloud)
Usage: Site header, footer, and meta tags
logo_filenameType:
string|nullStorage: File storage system (local or cloud)
Usage: Site header, footer, and meta tags
Logo Best Practices
Recommended Formats
Recommended Formats
- PNG with transparent background (preferred)
- SVG for scalability
- WebP for modern browsers
- Avoid JPEG for logos (no transparency)
Size Recommendations
Size Recommendations
- Width: 200-400px
- Height: 60-120px
- File size: Under 200KB
- Aspect ratio: 2:1 to 4:1 (landscape orientation)
Technical Requirements
Technical Requirements
- High contrast against both light and dark backgrounds
- Readable at small sizes (mobile)
- Optimized for web (compressed)
Hero Images
Hero Image System
SYNTIweb supports 3 hero images for different layouts and variations:Main Hero
Field:
Usage: Primary hero background or featured image
hero_main_filenameUsage: Primary hero background or featured image
Secondary Hero
Field:
Usage: Split layouts, galleries, or alternate views
hero_secondary_filenameUsage: Split layouts, galleries, or alternate views
Tertiary Hero
Field:
Usage: Multi-image carousels or triple-split layouts
hero_tertiary_filenameUsage: Multi-image carousels or triple-split layouts
Hero Layout Options
hero_layout field stores the selected layout variant. Common variants include:
- Fullscreen
- Split
- Carousel
Full-height hero with background image and centered text overlay
Hero Image Specifications
Dimensions
Dimensions
- Fullscreen: 1920x1080px (16:9)
- Split layout: 1200x800px (3:2)
- Mobile: 800x600px (4:3)
- Use responsive images with multiple sizes
File Format
File Format
- WebP (modern browsers) - Best compression
- JPEG (fallback) - Quality 80-85%
- PNG only if transparency needed
Optimization
Optimization
- Max file size: 500KB (compressed)
- Use lazy loading for secondary/tertiary
- Implement
srcsetfor responsive delivery - Consider CDN for faster delivery
Business Information
Tenant Model Fields
Core business information is stored in theTenant model:
Business Name
Field:
Type:
Used in: Site title, header, footer, SEO
business_nameType:
stringUsed in: Site title, header, footer, SEO
Slogan
Field:
Type:
Used in: Hero subtitle, meta description fallback
sloganType:
string|nullUsed in: Hero subtitle, meta description fallback
Description
Field:
Type:
Used in: About section, hero subtitle, meta tags
descriptionType:
text|nullUsed in: About section, hero subtitle, meta tags
Business Segment
Field:
Type:
Used in: Blueprint selection, categorization
business_segmentType:
stringUsed in: Blueprint selection, categorization
Business Hours Schema
The
is_open boolean acts as a manual override (e.g., for holidays or temporary closures).Content Blocks
Content Blocks System
Custom content is stored intenant_customization.content_blocks as JSON:
Content Block Structure
Content Helper Methods
About Section
About-Specific Fields
About Text
Field:
Type:
Usage: Rich text content for About sectionFalls back to
about_textType:
text|nullUsage: Rich text content for About sectionFalls back to
content_blocks.about.textAbout Image
Field:
Type:
Usage: Image for About section (team photo, office, etc.)
about_image_filenameType:
string|nullUsage: Image for About section (team photo, office, etc.)
About Section Configuration
The About section requires Plan 2 (CRECIMIENTO) or higher. See Sections for plan requirements.
Header Message
Announcement Bar
Header Message
Field:
Type:
Usage: Site-wide announcement bar above navigationExamples:
header_messageType:
string|nullUsage: Site-wide announcement bar above navigationExamples:
- “Envío gratis en compras mayores a $50”
- “Nueva sucursal abierta en el centro”
- “Black Friday: 40% de descuento”
Social Networks & Payment Methods
Social Networks
Payment Methods
WhatsApp Integration
WhatsApp Configuration
Sales WhatsApp
Field:
Format:
Usage: Product inquiries, orders
whatsapp_salesFormat:
+1234567890Usage: Product inquiries, orders
Support WhatsApp
Field:
Format:
Usage: Customer service, assistance
whatsapp_supportFormat:
+1234567890Usage: Customer service, assistance
The
whatsapp_active field determines which number is displayed in the floating WhatsApp button and contact sections.Call-to-Action (CTA) Section
CTA Configuration
CTA Default Configuration
The CTA section is available in all plans (Plan 1+) and is often used as a conversion-focused element.
FAQ Items
FAQ Configuration
Visual Effects
Visual Effects Configuration
Domain & SEO
Domain Configuration
Subdomain
Field:
Format:
Result:
subdomainFormat:
mybusinessResult:
mybusiness.syntiweb.comCustom Domain
Field:
Format:
Requires: Domain verification (
custom_domainFormat:
www.mybusiness.comRequires: Domain verification (
domain_verified)Meta Title
Field:
Length: 50-60 characters
Usage:
meta_titleLength: 50-60 characters
Usage:
<title> tag, search resultsMeta Description
Field:
Length: 150-160 characters
Usage: Search result snippets
meta_descriptionLength: 150-160 characters
Usage: Search result snippets
Custom domains require DNS verification. The
domain_verified boolean tracks verification status.Currency Display
Complete Branding Checklist
Related Documentation
Themes & Palettes
Color schemes and FlyonUI themes
Sections
Section ordering and configuration
Tenant Model
app/Models/Tenant.phpTenantCustomization Model
app/Models/TenantCustomization.php