> Updated for version 6.0.30

When you export your app as a **Direct link**, Celestory publishes a game page: your app in a phone, tablet or computer frame, with its description, its credits, a share button with a QR code and an install button. This article explains what the visitor sees and what you can set, in particular the **display formats** visitors can switch between.

![The game page of an app open in the Phone format, with the button bar (Formats, Full screen, Refresh, Install, Share) and the About and Credits panel on the left](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdklKIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--8b77a97fb39e225d15ececf7b7e3ecaa54d0cc1f/aide-visuels--page-de-jeu-telephone.en.png)
*The game page of an app open in the Phone format, with the button bar (Formats, Full screen, Refresh, Install, Share) and the About and Credits panel on the left.*

## What the visitor sees

The page shows the app in a frame, with a bar of buttons:

- **Formats**: the menu that changes the display format (it only appears if you ticked several);
- **Full screen**: the app alone, filling the window;
- **Refresh**: clears the app cache on the visitor's device and reloads the page;
- **Install**: adds the app to the home screen or the desktop;
- **Share**: the page address, its QR code, the embed code and the widget.

Next to the frame or under it, a panel shows the name, the version and the image of the project, then the **About** and **Credits** sections when you have filled them in.

The texts of the page itself (buttons, hints) are in French if the visitor's browser prefers French, in English otherwise. The content of the app is not affected.

> 🔺 **Note:** a button to chat with support can also appear at the bottom right of the page (**Chat with support**). It depends on the configuration of the Celestory server, not on a setting of your project.

## Where to find the settings

- Formats are chosen in the **Export** window (the **Export** entry of the project's general menu, or **Cmd + Shift + S** on Mac, **Ctrl + Shift + S** on Windows and Linux), **Direct link** tab, in the **Display format** area.
- The ratio, the description and the credits are set in the **Project settings** window (the **Project** entry of the project's general menu, or **Cmd + Shift + ,** on Mac, **Ctrl + Shift + ,** on Windows and Linux), with the fields **Project ratio**, **Project description** and **Credits**.

A setting made in the **Export** window applies to your **next export**: click **Export** to publish it.

## Choosing the display formats

1. Open the **Direct link** tab of the **Export** window.
2. In the **Display format** area, click the button that lists the ticked formats.
3. Tick one or more formats. At least one format stays ticked.
4. Click **Export**.

!["Publish project" window, Direct link tab: Display format menu open with the five formats, Phone and Computer ticked](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcDhKIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--ba147ae649daffc8c3453123669f71ed4649153c/project-export--direct-link-formats.en.png)
*the Display format menu open, with the five formats and their ticks*

| Format | What the visitor sees |
|---|---|
| Phone | The app in a phone frame, the way it looks in your hand |
| Tablet | The app in a tablet frame |
| Computer | The app in a browser window |
| Vertical, borderless | The app on the page, with no frame around it |
| Custom | Your own width and height |

The formats follow each other in this order in the menu. **The page opens on the first ticked format**, and a message under the button says so: "The page opens on Phone. Visitors can switch between the ticked formats."

### The Custom format

When **Custom** is ticked, two fields **Width** and **Height** appear, in pixels. Each value must be between 200 and 4000; a value outside these limits is brought back to the nearest one. The default size is 390 x 844.

### What the visitor does

- If you ticked a single format, the **Formats** menu does not appear on the page.
- If there are several, the visitor chooses in the **Formats** menu (name of each format and a short description). The page remembers the choice in their browser for the next visit.
- An address that asks for a format (for example the one copied from **Share** after a format change) opens the page on that format, if it is one of the ticked formats (**Vertical, borderless** is always accepted).
- When the page is embedded in another website (**Integrated** code), it opens in **Vertical, borderless**.

> ⚠ **Warning:** the **Vertical, borderless** format shows neither the **About** and **Credits** panel nor the **Install** button. Choose another format to show them.

## The project ratio and the ratio names

The **Project ratio** describes the shape of the screen you designed for. In **Project settings** (as in the **Project ratio** field of the debugger), the picker offers:

| Name | What it means |
|---|---|
| Portrait | Stays in portrait, centered on wide screens |
| Landscape | Stays in landscape, centered on tall screens |
| Responsive | Fills all the available space |

In the debugger, when you test the project, the **Preview screen ratio** picker gives more precise names:

| Name | Suggested use |
|---|---|
| Portrait 9:16 | Mobile, vertical video |
| Tall portrait 9:19.5 | Mobile with a tall screen |
| Extra tall portrait 9:21 | Mobile with an extra tall screen |
| Portrait 3:4 | Tablet |
| Square 1:1 | Social media, thumbnail |
| Landscape 4:3 | Tablet, classic computer screen |
| Landscape 16:9 | Computer, television |
| Wide landscape 19.5:9 | Mobile with a tall screen, held sideways |
| Panoramic landscape 21:9 | Wide computer screen, cinema |

On the game page, the ratio turns the frames. With a portrait ratio (Portrait, 9:16, 9:19.5, 9:21), the Tablet frame is turned to portrait. With a landscape ratio (Landscape, 16:9, 19.5:9, 21:9), the Phone frame is turned to landscape. With a square, 3:4, 4:3 or Responsive ratio, the frames keep their usual orientation (Phone in portrait, Tablet in landscape). The frame sizes are 390 x 844 for the phone, 1024 x 768 for the tablet and 1280 x 800 for the computer (in pixels).

To see how the app fits the screen, read [🖥 Adjust the ratio of my app](https://documentation.celestory.io/hc/celestorydoc/articles/fr-exports-ajuster-le-ratio-de-mon-app-9b0801).

## Writing "About" and "Credits"

The **About** section shows the **Project description** field, the **Credits** section shows the **Credits** field. Both are read as Markdown: bold, italic, links, lists, headings and tables are formatted. HTML you type is shown as plain text, with no effect.

- The **Project description** field accepts several lines; a list or a table works there.
- The **Credits** field is a single line: keep text, italic, bold or a link in it.
- Beyond 10,000 characters, the text is shown as it is, with no formatting.
- If both fields are empty, the panel does not appear.

Credits example: `Story: **Lea Martin**, music: [Studio Sons](https://example.com)`

The visitor can collapse each section (**Collapse** and **Expand** buttons) and the whole panel. The page remembers these choices on their device. A long description is cut with a **See more** / **See less** button.

## Sharing with a QR code

The **Share** button opens a window with four options:

| Option | What it gives |
|---|---|
| Presentation | The page with its frame, description and credits |
| Full screen | The app alone, filling the screen |
| Integrated | The code to put the app inside another website |
| Widget | A floating button to add to your website |

In **Presentation**, the page link is shown with a **Copy** button, and under it a **QR code**. The text next to it says: "Scan this code with a phone to open the app." Photograph the screen, or take a screenshot, to print or send it.

![The Share window, Presentation option, with the link, the Copy button and the QR code](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdk1KIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--fb3c6ea4728029003caa666ae6126c7fd4d6f7ef/aide-visuels--page-de-jeu-partager-presentation.en.png)
*The Share window, Presentation option, with the link, the Copy button and the QR code.*

If the visitor picked a format other than the opening one, the copied link and the QR code include it: whoever scans it gets the same format.

## Installing the app

The **Install** button in the bar adds the app to the home screen or the desktop, like an application.

1. Click **Install**.
2. If the browser offers the installation, confirm it.
3. Otherwise a bubble appears: "In your browser menu, choose Install app or Add to Home Screen." Follow it.

The installed app carries the name and the image of the project. It opens alone, full screen, without the bar of the page. The **Install** button disappears once the app is installed and in the **Vertical, borderless** format.

## Forcing an update

A visitor who sees an old version can click **Refresh**. The button clears the app cache on their device, then reloads the page. If that is not enough, the tooltip also gives the way to do it in Chrome: **Settings > More tools > Developer tools**, then right-click **Refresh > Empty cache and hard reload**.

See also [🔁 I can't see my app updating](https://documentation.celestory.io/hc/celestorydoc/articles/fr-exports-je-ne-vois-pas-mon-app-se-mettre-a-jour-b87e36).

## Troubleshooting

| Symptom | Solution |
|---|---|
| My app opens with no frame, no About or Credits | An app exported before formats existed opens in Vertical, borderless. Tick the format you want and export again |
| The Formats menu does not appear | Only one format is ticked: tick a second one and export again |
| My format choice is not applied | It applies to your next export: click **Export** |
| The Install button is missing | The format is Vertical, borderless, or the app is already installed |
| The page says "is not ready yet" | The app was not published, or its last publication did not finish: export it again |
| My description shows with no formatting | It is longer than 10,000 characters: shorten it |

## See also

- [📦 Direct Link Export of your app](https://documentation.celestory.io/hc/celestorydoc/articles/fr-exports-export-lien-direct-de-votre-app-f22939)
- [📦 Exporting a PWA](https://documentation.celestory.io/hc/celestorydoc/articles/fr-exports-exporter_pwa-815ca7)
- [🖥 Adjust the ratio of my app](https://documentation.celestory.io/hc/celestorydoc/articles/fr-exports-ajuster-le-ratio-de-mon-app-9b0801)
- [Adding a help chat to your app with My Celestory Help](https://documentation.celestory.io/hc/celestorydoc/articles/1795347825-adding-a-help-chat-to-your-app-with-my-celestory-help)
