In this section · 3 articles

How Demo Mode works

Demo Mode turns your Laramin into a read-only demo. Visitors can sign in, browse and search, but no change is saved and nothing can be exported. Learn what's blocked, what still works and what visitors see.

Applies to
Demo Mode 1.3 and later
Who can do this
Platform owner, Administrator
On this page

In short

Demo Mode is for a Laramin you show to other people, such as a public trial or a sales demo. While it's on, visitors can sign in, open every screen they're allowed to, search and filter, but nothing they do changes the shared data, and they can't take a copy of it. A ribbon across the top of every page says it's a demo.

Demo Mode applies to everyone, super admins included. Don't turn it on in the Laramin your business runs on.

Tip: Demo Mode is different from maintenance mode. Maintenance mode closes your Laramin to visitors. Demo Mode keeps it open but read-only. See Turn on maintenance mode.

How it works

What's blocked

BlockedDetails
Creating, editing and deletingEvery create, edit, delete and upload is refused, on every screen and through the API. Your Laramin checks twice: once when the request arrives, and again before any record is saved or deleted.
Exports and downloadsAny address whose name contains export or download is refused, because an export is a copy of the whole dataset. Someone with access to the server can allow exports again (see Set up and turn on Demo Mode).
Every settings panel but Demo Mode'sNo setting can be changed. The Demo Mode panel stays open to super admins, so the demo can always be switched off.

What still works

Still worksDetails
Browsing, searching and filteringLists load, search, sort and page normally.
Your own view preferencesSaved views, column layouts and saved filters, your notification preferences, and marking your own notifications read. These belong to each person, not to the shared data. See How saved views work.
Signing in and outSign-in, sign-out, signing out other sessions, password reset, password confirmation and email verification.
System recordsYour Laramin still records sessions, sign-in attempts, trusted devices, search history, activity log entries and SMS logs, or it couldn't serve a request at all.
Switching languageThe interface language changes for the visitor's session only. It isn't saved to the account, so visitors sharing a demo account don't change it for each other.
Whitelisted add-ons, routes and actionsAnything a super admin adds on the panel's Whitelisting tab can write, and export, as normal.

Commands run on the server, such as a scheduled job that resets the demo data each night, aren't blocked.

The Demo Mode panel lists all of this for your Laramin in two boxes, Disabled in the demo and Still works, built from the same settings the checks use.

What visitors see

  • The ribbon. A colored band above every page with Demo Mode, your warning message and a timer, In demo for. If you set a Call-to-action link, it also shows a Get your own instance button that opens that address.
  • Disabled buttons. Buttons that would save, delete, import or export are disabled. Pointing at one shows Disabled in the demo and the reason, for example "Deleting changes the data every other visitor sees, so it is switched off here."
  • A refusal dialog. If a change is refused anyway, a dialog says That change was not saved, and that nothing the visitor typed has been lost. Back to the form closes it and leaves the form as it was. For an export, it says Exports are off in the demo.

Apps and other programs that call the API get a 403 response with "demo_mode": true and your warning message.

On, off and locked

There are two switches, and the server's wins:

SwitchWho uses itEffect
Demo Mode Status on the Demo Mode panelA super adminActive or Inactive. Someone with server access can set the same value with php artisan demomode:toggle active or inactive.
DEMO_MODE in the server's .env fileWhoever runs your servertrue or false locks Demo Mode on or off. The panel shows Demo mode is locked by the environment and a Locked label on Demo Mode Status, and changing that field does nothing.

The bypass key

A Bypass Key is a secret that lets one request through the block. A request carries it as ?demo_bypass= followed by the key at the end of the address, or in an X-Demo-Bypass header. It's meant for your own scripts and API calls: each request must carry the key, so it doesn't make the screens writable for a visitor. A key set in the server's .env file (DEMO_MODE_BYPASS_KEY) is used instead of the one on the panel.

Who can change it

Only super admins. Demo Mode has no permissions to give through a role, and the panel is hidden from everyone else. See Super admin vs administrator.

What to do next