uL uLanding Docs

Troubleshooting

This chapter lists 100+ common problems and their solutions, grouped by topic. Use your browser's Find (Ctrl/Cmd+F) to search for your issue.

The golden first step Most "it's not updating" problems are caches. Before anything else, try clearing caches: bash php artisan optimize:clear Then hard‑refresh your browser (Ctrl/Cmd+Shift+R).

Installation & activation

  1. Plugin upload fails on Add Plugin. Confirm you selected a valid ZIP and entered a purchase code (15+ characters). Raise upload_max_filesize / post_max_size if the ZIP is large.
  2. Purchase code rejected. Re-copy the code from Envato (no spaces). Confirm you are installing on the licensed domain. See Installation.
  3. “Ultimate SMS version too old” during install. Upgrade Ultimate SMS to 3.6.0 or higher before installing uLanding.
  4. Plugin installs but menus don’t appear. Open Plugins → All Plugins and Enable uLanding. Refresh the admin sidebar.
  5. uLanding shows Inactive. Click Enable on the plugin card. Confirm your admin role can manage plugins.
  6. Themes list is empty after enable. Clear caches, re-open Themes, and confirm install migrations finished. Re-upload/update the plugin if needed.
  7. Migration errors during install. Check database credentials and that the DB user can create tables; the installer runs migrations automatically — retry Update/Install after fixing DB rights.
  8. “Class not found” after a manual file copy. Run composer dump-autoload (developer/manual installs only).
  9. Plugin folder in the wrong place. It must be at packages/codeglen/ulanding/ after a successful upload.
  10. Composer fails during upload. Your host must allow Composer for the PHP user. Use SSH manual install as a fallback (Installation).
  11. Admin screens blocked with a license / product error. Renew or re-verify your Ultimate SMS product license.
  12. Permissions: a team member can’t see a uLanding menu. Grant matching permissions (e.g. view pages) in Ultimate SMS roles.
  13. Images broken right after install. Run php artisan storage:link and ensure storage is writable.
  14. Demo mode blocks editing. Your install is in demo stage; editing may be disabled to protect the sandbox. Use a licensed install.

Images & media

  1. Uploaded images don't appear. Run php artisan storage:link.
  2. Storage link already exists but images 404. Delete the broken public/storage symlink and re‑run php artisan storage:link.
  3. Image upload fails silently. The file may exceed 2 MB (page builder images) — compress it.
  4. Video upload fails. Page‑builder videos max out at 50 MB; use a YouTube/Vimeo link instead.
  5. Upload rejected by the server. Raise upload_max_filesize and post_max_size in PHP settings.
  6. Demo images missing after import. Ensure the storage folder is writable and the storage link exists.
  7. Logo doesn't show. Re‑upload it in Customizer → Branding and Save.
  8. Logo disappears on dark sections. Upload a dark logo in Branding so the right one is used.
  9. Favicon not updating. Browsers cache favicons aggressively — hard refresh or test in a private window.
  10. Images load slowly. Compress them (aim < 300 KB) and use appropriately sized images.
  11. SVG icon not displaying. Make sure you pasted valid SVG code and selected SVG as the icon type.
  12. Image looks stretched/blurry. Use a higher‑resolution image with the right aspect ratio.

Pages

  1. Page shows 404 on the site. Set the page to Published.
  2. Can't save a page — slug rejected. You used a reserved slug (e.g. admin, blog). Pick another.
  3. Homepage is blank. Confirm the home page exists, is published, and the home slug matches ULANDING_HOME_PAGE_SLUG; clear caches.
  4. /home doesn't redirect to /. Check the home slug config and clear caches.
  5. Page content not showing. If "Use Page Builder" is on, add blocks; if off, fill the Content field.
  6. Members‑only page is public. Set the page visibility to Auth.
  7. Auth page redirects logged‑in users to login. Confirm the user is actually authenticated and has access.
  8. Edited page not updating. Save, then clear caches; saving a section also clears that page's cache.
  9. Deleted page still in the menu. Remove it from the menu in Menu Manage.
  10. Two pages with the same slug. Slugs must be unique; rename one.

Page Builder

  1. Page Builder won't load. Use a modern browser (Chrome/Firefox/Edge/Safari); check the browser console for JS errors.
  2. Widget library is empty. Clear caches; confirm the page builder addons config is present.
  3. Can't drag blocks. Disable conflicting browser extensions; try another browser.
  4. Block won't save. Check your connection; look for an error toast; try again.
  5. Saved block not on the live page. The page must be Published; clear caches.
  6. Changing a layout hid some fields. Different layouts show different fields — your data is kept; switch back to see them.
  7. Duplicated block didn't copy content. Re‑duplicate; ensure the original was saved first.
  8. Block order won't stick. Drag by the handle and wait for the save confirmation.
  9. Responsive preview toggle does nothing. Refresh the builder; check the console.
  10. Media upload in builder fails. File too large (2 MB images / 50 MB video) — compress or link.
  11. Two blocks overlap. Check column settings; a full‑width block placed in a column can misbehave — move it to a full‑width zone.
  12. Columns won't change. Use the column switcher in the toolbar; some pages use row mode instead.
  13. Lost a block by accident. There's no undo — re‑add and reconfigure it.
  14. Preview looks different from live. Preview ignores save; Save then view the live page.

Widgets (page builder content blocks)

  1. Service Section is empty. Publish your services; check the category filter.
  2. Brand Section shows no logos. Add and publish brands.
  3. Blog Section shows no posts. Publish posts; check the category filter.
  4. Testimonial Section empty. Publish testimonials.
  5. Pricing Section empty. Make plans Visible and Active.
  6. Counter numbers don't animate. Set Customizer animation level to Full.
  7. Hero video popup won't open. Use a full, valid video URL.
  8. FAQ accordion won't expand. Each item needs a question and answer; save.
  9. Map Section pins overlap. Give each pin a different position class.
  10. Contact form not received. Check the form action and your email settings.
  11. Map embed blank (Contact). Use a Google Maps embed URL, not a share link.
  12. Pricing toggle (monthly/yearly) missing. Use the Toggle Card Grid layout.
  13. Popular badge missing. Mark one plan as Popular in Price Plan admin.
  14. Text Slider doesn't scroll. Enable autoplay/loop and set a speed.
  15. Process/Step section empty. Add items to the repeater.

Themes

  1. Activated theme but site looks unchanged. Clear caches; hard refresh.
  2. Theme preview shows old content. It uses demo defaults, not your live content — that's expected.
  3. Demo import button does nothing. Confirm uLanding is Active and you have the manage themes permission.
  4. Demo import times out. Raise max_execution_time and memory_limit; retry.
  5. "Theme not supported" on import. Only the 10 built‑in themes can be imported.
  6. Site uses wrong theme after deactivate. Activate the theme you actually want.
  7. Switched theme and pages look off. Some block layouts match specific themes; adjust block variants.
  8. Theme colors revert. You may be editing legacy settings — use the Customizer and Save.
  9. Two themes seem active. Only one can be active; re‑activate the correct one and clear caches.

Theme Customizer

  1. Customizer changes don't appear on the site. Click Save, then clear caches.
  2. Live preview not updating. Refresh the customizer; check the console.
  3. Colors won't change. Make sure you're in the Colors panel and saved.
  4. Fonts not applying. Save; clear caches; confirm the font name is correct.
  5. Custom CSS broke the layout. Remove or fix the last CSS you added.
  6. Header scripts not loading. Verify the script is valid; some need to load in the footer instead.
  7. Logo upload in customizer fails. File too large; compress under ~2 MB.
  8. Site width change has no effect. Save and clear caches; theme container may also apply.
  1. Header not sticky. Enable sticky in Customizer → Header (note Minimal/Creative‑Agency are non‑sticky by design).
  2. CTA button missing. Enable it and set a label/URL in Customizer → Header.
  3. Sign In/Up buttons missing. Enable them in Customizer → Header.
  4. Search icon missing. Search depends on the header type; switch to one that includes it.
  5. Top bar not showing. Enable the top bar in Customizer → Header (or Off‑Canvas → Top bar).
  6. Mega menu shows as normal menu. Set menu type to Mega and enable the mega menu in Customizer → Menu.
  7. Header overlaps the hero. This is intended for transparent headers; adjust hero padding or header type.
  8. Wrong logo in header. Upload both light and dark logos in Branding.
  1. Footer is empty. Add widgets in Widget Builder → Footer and Save.
  2. Footer widget not visible. Check its Advanced → "Hide on…" device settings.
  3. Blog widgets missing from the library. They appear only in the Blog Sidebar area.
  4. Footer columns wrong. Set the column count in the footer area.
  5. Seeded demo footer wiped my widgets. Seeding replaces footer widgets — only use on a fresh footer.
  6. Copyright year is wrong. Use {year} placeholder so it's always current.
  7. Newsletter widget doesn't submit. Set a valid action URL and check email settings.
  8. Google Map widget blank. Use a proper embed URL.
  9. Footer style (background) not applying. Enable the footer style toggle and Save.
  10. Divider not full width. Place it in a full‑width zone; set placement before/after.

Off‑canvas (slide‑in menu)

  1. Off‑canvas won't open. Ensure it's enabled in Customizer → Off‑Canvas; check for JS errors.
  2. Off‑canvas menu empty. Turn on "Show menu" and select a menu source.
  3. Off‑canvas too narrow/wide. Adjust the width setting (or Custom width).
  4. Contact info not showing in off‑canvas. Enable each contact row and fill its value.
  5. Social icons missing in off‑canvas. Add social links in Customizer → Social and enable "Show social".
  6. Overlay too dark/light. Adjust the overlay color.
  1. Menu not showing in header. Set a menu as default.
  2. Dropdown not appearing. Nest child items under a parent by dragging.
  3. Menu order won't save. Drag items and wait for the auto‑save.
  4. Custom link goes to the wrong place. Edit the item's URL.
  5. Footer menu empty. Add a Menu widget and select the menu.
  6. Sign In/Up appear twice. They're header settings, not menu items — remove duplicates from the menu.

Blog

  1. Posts don't show at /blog. Set posts to Published.
  2. Comments not appearing. Enable comments in Settings; approve them if moderation is on.
  3. Spam comments showing. Turn on comment moderation.
  4. Author not shown on posts. Enable "Show author bio" in Blog Settings.
  5. Blog sidebar empty. Build it in Widget Builder → Blog Sidebar.
  6. Category page shows nothing. Assign posts to that category.
  7. Blog archive header wrong. Set the blog header title/image in Settings.
  8. Wrong number of posts per page. Adjust "posts per page" in Settings.

Services

  1. Service not on the page. Publish it; check the Service Section's filter.
  2. Service detail page 404. Enable detail page, set a slug, publish, clear caches.
  3. Detail page missing a section. Fill the matching content field or enable the toggle.
  4. Related services empty. Assign the service to a category with other published services.
  5. Service card image missing. Upload a thumbnail.
  6. Service tabs empty. Assign services to categories.

Pricing / Testimonials / Brands

  1. Pricing card missing. Make the plan Visible and Active.
  2. Wrong price shown. Check the linked billing plan and its cycle.
  3. Testimonial not shown. Publish it.
  4. Testimonial stars missing. Set a rating.
  5. Brand logo missing. Publish the brand; add the logo.
  6. Brand logos uneven. Use consistent, transparent logos.

Performance & caching

  1. Site is slow. Compress images; reduce animations; enable server caching.
  2. Changes lag behind. Pages cache for 6 hours — saving clears the relevant cache; otherwise run optimize:clear.
  3. High memory use during import. Raise memory_limit.
  4. Too many large images. Optimize and resize before uploading.
  5. Heavy animations stutter. Lower the Customizer animation level to Reduced.

Front‑end build / assets

  1. "Unable to locate file in Vite manifest". Run yarn run build (or yarn run dev).
  2. Styles look broken/unstyled. Assets weren't published or built — re‑publish assets and build.
  3. JavaScript features (sliders) not working. Check the console; rebuild assets; clear caches.
  4. Package assets 404 (_assets/...). Confirm the plugin's resources/assets exist and the route is reachable.

General / miscellaneous

  1. 404 page not customized. Set it in Appearance → 404 Settings.
  2. Everything looks off after an update. Run php artisan migrate and php artisan optimize:clear.
  3. Dark mode won't turn on. Set theme mode in Customizer → General; clear caches.
  4. Auto mode not following device. Auto uses the visitor's system preference; test on a device set to dark.
  5. A single block is the wrong mode. Check that block's Theme Mode (Inherit/Light/Dark).
  6. Translations partly in English. Add the missing keys; run ulanding:audit-translations.
  7. RTL layout broken. Confirm the language is RTL and clear caches.
  8. Schema/rich results not showing. Validate JSON‑LD with Google's tool.
  9. Social share shows no image. Set the OG image and re‑scrape with the platform debugger.
  10. Sitemap missing. uLanding doesn't generate one; submit URLs via Search Console.
  11. Still stuck. Note the exact error, the page/screen, and what you changed last, then contact support with those details.

Quick diagnostic commands

php artisan optimize:clear        # Clear all caches (config, route, view, app)
php artisan config:clear          # Clear config cache only
php artisan storage:link          # Fix missing images
php artisan migrate               # Apply database updates
php artisan ulanding:audit-translations --locale=en   # Find missing translations

Continue to the FAQ.