Templates
Add templates to an event with Create in Studio, Open File or From Gallery, then order, switch and fine-tune each one.
Templates are the experiences guests choose from: a framed photo, a strip, an AI look, a boomerang and so on. In CONTENT › Templates you add templates to the event, switch them on or off, put them in order and give each one its own settings.
Chapters (11)
Chapters (12)
Before you start
- Open the event in the Event Editor (see Events overview).
- Every template is built in a studio. How to design each kind is explained in its own article, for example Photo Studio, Collage Studio or AI Offline Studio. This article covers only adding and managing templates inside an event.
- An event needs at least one template before it can be launched.
Three ways to add a template
Open CONTENT › Templates. Three buttons sit at the top right: Create in Studio, Open File and From Gallery.

Create in Studio
Builds a new template on the spot and adds it to this event. Best for a template meant for this occasion only.
- Click Create in Studio. The Select Studio To Launch dialog opens, showing only the studios your license allows. Art Studio is in every license (since 5.9.6.0).
- Pick a studio. It opens in its own window, with the calling event's name, a large Save & Return button and Cancel at the top of the left panel.
- Design the template as usual (see the studio's article).
- Click Save & Return. The template appears as a new row in the Templates list. Cancel returns without adding anything.
If the event has been saved at least once, the new template is kept straight away; there is no need to click Save in the Event Editor (since 5.3.1.0). A brand-new event that was never saved keeps nothing until you click Save there.
Open File
Adds template files you already have on disk, for example templates a colleague sent you.
- Click Open File. A Windows file picker opens.
- Select one or more template files (hold Ctrl to pick several).
- Click Open. Each file becomes a new row.
From Gallery
Adds templates from the Template Gallery, where you save templates you want to reuse and where ready-made templates can be downloaded.
- Click From Gallery. The Choose a Template window opens.
- Choose Local (templates on this computer) or Cloud (ready-made templates to download) with the two wide buttons across the top (since 5.8.0.0; before, they were two small tabs at the top-left). Use the folders on the left, the TYPE filter and the search box to find what you need. The Cloud template pictures are saved on this computer the first time they load, so the next time the Cloud tab shows them straight away (since 5.9.6.0).
- Click the templates you want to tick them; several can be selected at once. Select All / Clear sit at the top. Ticks are cleared when you change folder, filter or search, so add one folder's batch at a time.
- Click Add Selected (n).

Only templates that use the guest's photo can run in an event. The gallery is already filtered to AVAILABLE FOR EVENT; templates that only create an image or video from text are skipped, because there is nowhere to put the guest's photo. A cloud template downloads first, and if some picks turn out not to work in an event, the rest are added and a message says how many were skipped.
Cloud AI Online templates are made on fal.ai. Since 5.8.2.0, when one downloads, the app sets it to an AI service this booth can pay with:
- The booth has a fal.ai key: it stays on fal.ai, nothing changes.
- No fal.ai key but a WaveSpeed key (Expert mode only): WaveSpeed, if WaveSpeed has the same model.
- Otherwise: Built-in (paid with QBooth tokens), if Built-in is offered on this license and has the same model.
- Otherwise (Bleep, or dongle booths on 5.9.6.0 or older, with no key): it stays on fal.ai and asks for a fal.ai key. Dongles get Built-in from 5.9.6.1.
Easy mode skips the WaveSpeed step. To use a different service afterwards, open the template and change its provider (see AI Online Studio).
When a template is refused
Whichever way you add it, Q-Booth refuses a template when:
- your license doesn't include its studio (Your current license doesn't allow … templates), or
- it can't use a guest photo (This template can't be used in an event). Text-to-image and text-to-video AI templates have nowhere to put the guest's photo; rebuild the template so it takes the captured photo as its source.
A newly added template's caption starts as the template's own event caption, or the file name if it has none.
Which way to choose?
| Situation | Use |
|---|---|
| A template only for this event | Create in Studio |
| A template you will reuse in many events | Build it from the Studio sidebar, save it to the Template Gallery, then From Gallery |
| Template files you received or keep in a folder | Open File |
| Ready-made templates | From Gallery › Cloud |
Template file types
Each studio saves its own file type. Open File accepts all of these:
| Extension | Made in |
|---|---|
.qsd | AI Offline Studio (Face Swap templates use it too) |
.qso | AI Online Studio |
.qsp | Photo Studio |
.qsc | Collage Studio |
.qsm | Motion Studio (music and assets are inside the file) |
.qsl | Lenticular Studio |
.qsf | Flipbook Studio |
.qsb | Flipbook downloaded from the Cloud gallery |
.qsg | Augmented Reality Studio |
.qsk | Art Studio (since 5.9.6.0) |
The full list of Q-Booth file types is in the Reference.
The template list
| Column | What it shows or does |
|---|---|
| # | The order guests see. Drag the handle at the left of a row to move it. |
| THUMB | The cover guests see on the Template Picker. Click it to choose From Gallery..., Browse File..., Clipboard or Remove cover. A cover can be a short video, which plays on the picker card (since 5.5.0.0). Since 5.9.0.0 the app keeps a copy up to 1600 pixels wide, so covers stay sharp even on big cards. If covers look blurry on big cards after updating, pick the cover again: covers picked before the update stay at the old, smaller size. |
| CAPTION | The title guests see. Click it to edit directly in the row. |
| CATEGORY | Click the chip to choose a category from the event's list; - means none. See Categories. |
| STATUS | On/off switch. A switched-off template stays in the list but guests do not see it. |
| TYPE | The kind of template (for example Online AI, Offline AI, Collage). Click the pill to open the template in its studio and edit it; Save & Return updates the event (since 5.5.0.0). |
| Gear icon | Advanced settings for this template in this event. |
Toolbar
- Search... and the category filter (appears once the event has categories) narrow the list.
- List view / Card view switch the layout.
- Delete template (or the Delete key) and Duplicate template act on the highlighted row. A duplicated template gets its own copy of the file, so editing the copy never changes the original.
- Move to top, Move up, Move down, Move to bottom change the order. You can also drag rows by the handle on the left.
The move buttons keep working while a search or category filter is on: the row hops past hidden rows to land next to the one you can see.
Switch templates on or off
Use the STATUS switch to hide a template for a while (for example an AI template when the internet is down) without losing its settings. Switch it on again whenever you like.
Change many templates at once
Select mode works on many templates at once (since 5.3.0.0).
- Click Select.
- Click the rows you want to change, or use Select All / Unselect All; the counter shows how many are selected.
- Use Set Category, Set Status or the delete icon (Delete selected templates).
- Click Done.

Advanced settings of a template
Click the gear icon on a row to open Edit Template. These settings apply to this template in this event only.

| Section | Options |
|---|---|
| TEMPLATE STATUS | On/off, the same as the list switch. TEMPLATE ID with a copy button. |
| TEMPLATE SOURCE | The template file. Edit opens it in its studio, Template Info shows its details, and Replace swaps in another template (with Create in Studio, Open File or From Gallery). Replace keeps the row's caption, category and settings. |
| DISPLAY | CAPTION (Default puts back the template's own caption), CATEGORY, and COVER IMAGE: an optional picture that replaces the template's own thumbnail on the Template Picker. |
| KEYBOARD SHORTCUT | A modifier (None, Ctrl, Alt, Shift, Ctrl+Alt, Ctrl+Shift) and a key. Pressing it on the live Template Picker picks this template. Handy with an external button box or keyboard. |
| CAMERA & PRINTER | DEFAULT CAMERA: Camera 1 or Camera 2. CAMERA ORIENTATION: Default uses that camera's own rotation from Settings; Custom shows ORIENTATION MODE (and Flip result to original for mirrored modes). PRINT SETTINGS (since 5.3.2.0): Default; Specific Printer, so this template always prints to one printer (if that printer is unavailable, printing falls back to automatic); or Custom, where Configure gives it its own printer setup. |
| Result Delivery | Use event setting follows the event's Result Delivery; Custom sets this template's own Direct / Email a link / Manual pickup / Scan a QR now / Text a link (since 5.9.2.0). |
Click Save in the dialog to keep the changes. Templates save themselves, so there is no need to save the event as well (unless it is a brand-new event that was never saved).
Edit a template later
- Click the TYPE pill on the template's row (or the gear › Edit). The template opens in its studio.
- Make your changes, then click Save & Return. The event is updated (since 5.5.0.0).
To use a completely different file for the same row (keeping its caption, category and settings), use Replace in Edit Template.
Tips
- Put your best seller first: guests usually pick from the first few cards.
- Use short, clear captions; long names are cut off on small cards.
- Give AI templates a cover image that shows the finished look, so guests know what they will get.
- With many templates, group them into categories.
- Test every template once with Launch (F5) before the show.
Common problems
"This template can't be used in an event."
The template does not use the guest's photo (for example a text-only AI template). Rebuild it so it takes the captured photo as its source.
"Your current license doesn't allow … templates."
That template type is not included in your license tier. See Introduction for the editions.
"The template file for this row is missing."
The row's template file was moved or deleted. Use Replace in Edit Template, or add the template again with Open File or From Gallery.
Can I reorder templates while a search or filter is on?
Yes. The Move buttons keep working: the row hops past hidden rows to land next to the one you can see. The order in the list is the order guests see.
A template does not appear at the booth.
Check that its STATUS is on, that its category is switched on, and that the Template Picker shows that category (see Template Picker).
Next steps
Still need help?
Our team answers on WhatsApp. Tell us your Q-Booth version and what you see on screen.