Overview
Larapen's settings system lets you configure every aspect of your website from a single, organized interface. Settings are grouped into logical sections: General, SEO, Mail, Social, Media, and more. Changes take effect immediately and are cached for optimal performance.
To access settings, go to Settings in the admin sidebar. The settings page displays a left-hand sidebar with all available groups and the active group's fields on the right.
Settings groups
General
Core site-wide settings.
| Setting | Description |
|---|---|
| Site Name | Your website's name. Appears in the browser title bar, emails, and header (when no logo is set). |
| Tagline | A short motto or slogan displayed under the site name in some themes. |
| Description | A brief description of your site, used as the default meta description for SEO. |
| Logo | Upload your site logo (PNG, SVG, or JPG). Displayed in the header and emails. |
| Favicon | The small icon shown in browser tabs. Recommended: 32×32px PNG or ICO. |
| Google Maps API Key | Required to display Google Maps on contact or location pages. |
| Timezone | Your website's timezone. Affects how dates and times are displayed. |
| Date Format | How dates are displayed (e.g., Y-m-d, d/m/Y, m/d/Y, F j, Y). |
| Purchase Code | Your Envato purchase code for license verification. |
| Maintenance Mode | When enabled, visitors see a maintenance message instead of the site. Admins can still access the admin panel. |
| Maintenance Message | The message shown to visitors during maintenance. |
| Auto-hide Flash Messages | Automatically dismiss success/error notifications after a set duration. |
Page Header
Controls the appearance of the page header banner shown at the top of inner pages.
| Setting | Description |
|---|---|
| Show Page Header | Master toggle: hides the entire page header when disabled. |
| Show Title / Subtitle / Breadcrumb / Sub-nav | Individual toggles for each element within the page header. |
| Height | Page header height in pixels (e.g., 200px). |
| Background Color | Solid background color for the page header. |
| Background Image | Upload an image for the page header background. |
| Overlay Opacity | Darkness of the overlay on top of the background image (0–100%). |
| Title / Subtitle / Breadcrumb Colors | Individual color pickers for text elements. |
Contact
Settings for the contact page and contact form behavior.
| Setting | Description |
|---|---|
| Page Title / Subtitle | Translatable title and subtitle shown on the contact page. |
| SEO Title / Description | Translatable meta tags for the contact page. |
| Contact Email / Phone / Address / Hours | Your business contact information displayed on the page. |
| Form Submission Method | Where form submissions are sent: Database (stored in admin), Email (sent to notification email), or Both. |
| Notification Email | Email address that receives form submissions (when method includes email). |
| CAPTCHA | Enable CAPTCHA protection on the contact form (requires CAPTCHA configured in Settings → CAPTCHA). |
| Map Settings | Enable/disable the map, choose provider (Google Maps or OpenStreetMap), set address or coordinates, zoom level, and map height. |
SEO
Search engine optimization defaults.
| Setting | Description |
|---|---|
| Default Meta Title | Translatable. Used when a page doesn't define its own meta title. |
| Default Meta Description | Translatable. Recommended: under 160 characters. |
| Default Meta Keywords | Translatable. Comma-separated keywords. |
| Title Separator | Character between page title and site name (e.g., |, -, –). |
| Title Format | Order: "Page | Site", "Site | Page", or "Page only". |
| Default OG Image | Image shown when pages are shared on social media (recommended: 1200×630px). |
| Google Analytics ID | Your Google Analytics 4 measurement ID (format: G-XXXXXXXX). |
| Head Scripts | Custom HTML/JavaScript injected into <head> on every page. Useful for tracking pixels, custom meta tags, or external scripts. |
Email delivery configuration. Larapen supports multiple mail drivers:
- SMTP: Standard email server (host, port, username, password, encryption).
- Mailgun: Mailgun API (domain, secret, endpoint).
- Postmark: Postmark API (token).
- Amazon SES: AWS SES (key, secret, region).
- SparkPost: SparkPost API (secret).
- Resend: Resend API (key).
- MailerSend: MailerSend API (API key).
- Brevo: Brevo API (formerly Sendinblue) (API key).
- Sendmail: Local sendmail binary (path).
All drivers require a From Address and From Name: the sender identity for all outgoing emails.
Social Links
Your social media profile URLs. These appear in the website footer and can be used by themes in headers or sidebars.
Supported platforms: Facebook, Twitter/X, Instagram, LinkedIn, YouTube, GitHub, TikTok, Pinterest.
Leave a field empty to hide that platform's icon.
Social Auth
Allow users to register and log in using their social media accounts. Each provider requires OAuth credentials:
- Create an OAuth app on the provider's developer portal.
- Enter the Client ID and Client Secret.
- Copy the auto-generated Callback URL from Larapen into your OAuth app settings.
- Enable the provider's toggle.
Social Share
Configure which content types can be shared and on which networks.
Content types: Pages, Portfolio Items, Blog Posts (if Blog active), Shop Products (if Shop active).
Networks: Facebook, Twitter/X, LinkedIn, Pinterest, WhatsApp, Telegram, Email.
Media
File upload and image processing settings.
| Setting | Description |
|---|---|
| Max File Size | Maximum upload size in KB. |
| Max Image Width / Height | Images larger than this are automatically resized on upload. |
| JPEG/WebP Quality | Compression quality (1–100). Lower = smaller files, reduced quality. |
| Convert to WebP | Automatically convert uploaded images to WebP format for better performance. |
| Auto-generate Thumbnails | Create small, medium, and large versions of each uploaded image. |
| Thumbnail / Medium / Large Sizes | Width and height in pixels for each auto-generated size. |
| Allowed Image / Document Types | Comma-separated file extensions allowed for upload. |
WYSIWYG Editor
Choose the rich text editor for content editing, separately for admin and front-end:
- None: Plain textarea (no formatting).
- TinyMCE 7/8: Full-featured editor with toolbar options (minimal, standard, full), skin themes, and custom height.
- CKEditor 4/5: Classic editor with configurable toolbar and language.
- Jodit: Open-source WYSIWYG editor.
- Quill: Lightweight modern editor with Snow or Bubble theme.
- Summernote: Simple, lightweight editor with configurable toolbar.
- Trix: A rich text editor by Basecamp.
- ZynText: Simple text editor.
Localization
Language detection, URL behavior, and GeoIP settings. See the dedicated "Localization Settings" article in the Localization & Languages collection for full details.
CAPTCHA
Protect forms from spam with CAPTCHA verification.
- reCAPTCHA v2: Checkbox challenge ("I'm not a robot"). Requires Site Key and Secret Key from Google.
- reCAPTCHA v3: Invisible score-based detection. Requires Site Key, Secret Key, and score threshold (0–1).
- Cloudflare Turnstile: Privacy-friendly alternative. Requires Site Key and Secret Key from Cloudflare.
Security
HTTPS enforcement and other security-related settings.
AI
AI provider configuration for content generation and translation features.
- Select the AI provider (OpenAI, Anthropic, Gemini, etc.).
- Enter the API key for the chosen provider.
- Configure model settings (model name, temperature, max tokens).
Cache
Cache driver configuration for optimal performance.
Supported drivers: File (default), Database, Memcached, Redis, DynamoDB, Octane, Array.
The "Clear Cache" button at the bottom flushes all cached data: useful after making configuration changes or troubleshooting display issues.
Queue
Queue driver configuration for background job processing.
Supported drivers: Sync (default), Database, Beanstalkd, Amazon SQS, Redis.
Translator
Automatic translation driver configuration for translating content and language files.
Supported drivers: Google Translate, DeepL, Microsoft Translator, Amazon Translate, Yandex Translate.
Enter the API key for the chosen provider.
Currency Exchange
Exchange rate driver configuration for multi-currency support (used by the Shop add-on if active).
Configure the exchange rate provider, API keys, and cache TTL.
Notifications
Configure the admin notification system:
- Enable/Disable notifications: Master toggle for the notification system.
- Refresh method: How notifications are updated:
page_load(on navigation, default),polling(AJAX at configurable interval), orreverb(real-time via Laravel Reverb WebSocket). - Polling interval: When using polling, the interval in seconds (5–300).
- Reverb settings: Host, port, scheme, and app key for the Reverb WebSocket server.