> ## Documentation Index
> Fetch the complete documentation index at: https://getfaceage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Fullscreen

> The scan as an app: it opens right away over the whole screen, on every device.

In fullscreen mode the analysis is the page. It opens as soon as `render()` runs and covers the whole screen — edge to edge, on phones, tablets and desktops. There is no floating button to open it and no close button. No container element is needed.

Use it on a page that exists only for the scan.

## Add fullscreen

```js theme={null}
import FaceAge from 'face-age';

const faceAge = new FaceAge({
  faceageId: '<Your Client ID>',
  displayModel: 'fullscreen',
});

faceAge.render();
```

## Modal vs fullscreen

| | Modal (`'modal'`) | Fullscreen (`'fullscreen'`) |
| - | - | - |
| Opens | When the shopper clicks the floating button | Right away, on `render()` |
| Floating button | Yes | No |
| Close button | Yes, in the top bar | No — it can't be closed |
| Container (`elementId`) | Not needed | Not needed |
| On phones | Covers the whole screen | Covers the whole screen |
| On tablets and desktops | A centered window (90% of the screen, up to 1140 × 800 px) with rounded corners over a dimmed page | Covers the whole screen, edge to edge, with no frame |
| Page behind it | Visible around the window, scrolling locked | Hidden, scrolling locked |
| `onCloseModal` event | Fires on close | Never fires |
| `openModal` / `closeModal` analytics | Yes | No |

Everything else — quiz, products, routines, history, discounts, languages — works the same as in the other modes.

## Layout

* The analysis fills the full width and height of the browser window and follows resizing and rotation.
* On phones it uses the visible screen height, so the browser's address bar and toolbar don't cut off the bottom of the screen.
* On phones with a notch or rounded corners, the content stays inside the safe area.
* `width` and `height` are not used in this mode.

## When to use it

* A dedicated scan page — for example `/skin-analysis` — or a web app saved to the home screen.
* A large screen such as an in-store tablet or kiosk, where the scan should take the whole display.

> [!TIP]
>
> Want shoppers to open the scan from your normal pages and go back to them? Use [modal mode](https://getfaceage.com/docs/developer-guides/display-modes/modal.md) instead.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.