> For the complete documentation index, see [llms.txt](https://manual.bubble.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.bubble.io/help-guides/previewing-your-app/previewing-a-web-app.md).

# Previewing a web app

How to preview a Bubble web app inside the editor or in a new browser tab, test it as a specific user, and use safe preview options to isolate issues.

{% hint style="info" %}
This section describes previewing **web apps**. If you're looking for documentation on previewing **native mobile apps**, see the article below:

**Article:** [Previewing a mobile app](https://manual.bubble.io/help-guides/previewing-your-app/previewing-a-mobile-app.md)
{% endhint %}

Bubble makes it easy to preview your web app while you build. Previewing lets you test functionality, check design changes, and make sure everything works the way you expect before deploying[^1] your app to live users.

This article explains the different ways you can preview your web app from the Bubble editor.

## Preview options

You can preview your app inside the editor with the play icon, or open it in a separate browser tab with the new tab icon in the top-right corner of the editor. Here's how the two compare:

<table><thead><tr><th width="168.11328125">Method</th><th>Where it opens</th><th>Best for</th></tr></thead><tbody><tr><td><a href="#preview-mode">Preview mode</a></td><td>Inside the editor</td><td>Quickly checking a change, and testing your app as different users</td></tr><tr><td><a href="#full-preview">Full preview</a></td><td>In a new browser tab</td><td>Testing the full page in a regular browser window, such as with the <a data-footnote-ref href="#user-content-fn-2">debugger</a></td></tr></tbody></table>

## Preview mode

You can preview your app without leaving the editor. Instead of opening your app in a new browser tab, the preview loads right where you're working, so you can check a change and get back to building in a few clicks.

### Opening preview mode

{% stepper %}
{% step %}

#### Open the page you want to preview

Use the page dropdown in the top bar to open the page you want to test.
{% endstep %}

{% step %}

#### Click the play icon

Click the play icon at the top of the left-hand toolbar. Your page loads in the editor, and you can click, type, and run workflows just as your users would.
{% endstep %}

{% step %}

#### Go back to editing

When you're done, click one of the other icons in the left-hand toolbar, such as the **Design** tab, to go back to building.
{% endstep %}
{% endstepper %}

### Previewing as a specific user

Many apps look and behave differently depending on who's logged in. An admin may see pages that regular users can't, and each user sees their own data. With *Preview as*, you can run your app as a specific user from your database, and check what they see without logging in and out yourself.

{% stepper %}
{% step %}

#### Open the Preview as dropdown

In preview mode, click the *Preview as* dropdown in the top bar.

<figure><img src="https://34394582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M5sbzwG7CljeZdkntrL%2Fuploads%2FygEmCisW1K3SfRSRTDRG%2Fpreview-as.png?alt=media&amp;token=719e668f-2bfe-46b1-b205-9726eebf08cf" alt="The Preview as dropdown open in the top bar of the editor, listing a Logged out user option and several user email addresses."><figcaption><p>The <em>Preview as</em> dropdown lists the users in your database, along with a logged-out user.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Select a user

Select the user you want to preview as. The preview reloads, and your app now runs as if that user were logged in.
{% endstep %}

{% step %}

#### Switch between users

To compare how your app works for different users, select another user from the dropdown. You can switch as often as you need while you test.
{% endstep %}
{% endstepper %}

Previewing as a user follows that user's permissions, including your [privacy rules](#user-content-fn-3)[^3]. That makes it a quick way to check that each user only sees the data they're supposed to, such as making sure a regular user can't see another user's posts.

{% hint style="warning" %}
The preview runs your app for real. If you save a form, delete a record, or run any other workflow while previewing as a user, the change is made in your database as if that user had done it.
{% endhint %}

## Full preview

<figure><img src="https://34394582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M5sbzwG7CljeZdkntrL%2Fuploads%2Fuw5ZjYn4NHDhNpwKzZEN%2Fpreview-button.png?alt=media&amp;token=a0916782-f585-438d-9576-51eda7946c6f" alt="The Bubble editor with the Design tab open and the new tab icon, with its dropdown arrow, highlighted in the top-right corner."><figcaption><p>The new tab icon in the top-right corner opens your app in a new browser tab.</p></figcaption></figure>

To open a full preview, click the new tab icon in the top-right corner of the editor. This opens a new browser tab showing your app's [development version](#user-content-fn-4)[^4]. It loads the full development version, including:

* All custom HTML
* All installed plugins[^5]
* All workflows and elements

This is the standard way to test your app. The dropdown arrow next to the icon also offers debug mode and a few safe preview options, which can help when debugging or isolating potential issues.

### Debug mode

This option opens your app with the debugger[^2] turned on, so you can step through your workflows and inspect your elements while the app runs.

### Safe preview options

The safe preview options turn off custom code in your app, so you can find out whether that code is causing a problem.

#### Disable custom HTML

This option disables any custom HTML elements you've added through the [HTML element](#user-content-fn-6)[^6] or the [page header](#user-content-fn-7)[^7].

Use this if you're experiencing rendering issues or suspect your custom code might be affecting the app.

#### Disable plugins

This option disables all plugins, allowing you to test your app without third-party code. Use this if you think a plugin is causing a problem in your app.

#### Disable HTML & plugins

This option disables both plugins and custom HTML. Use this if you're encountering persistent issues and want to isolate whether the problem is being caused by third-party code.

### Opening debug mode and safe preview options

{% stepper %}
{% step %}

#### Open the dropdown

Click the downward arrow next to the new tab icon.
{% endstep %}

{% step %}

#### Choose an option

Choose the option you want to use:

* Debug mode
* Disable custom HTML
* Disable plugins
* Disable HTML & plugins
  {% endstep %}
  {% endstepper %}

Each option opens your app in a new browser tab.

### Note on preview URLs

All of these options load your app in the development version. The URL will include `version-test`, like so:

```
https://yourapp.bubbleapps.io/version-test
```

This version is separate from your live app and only reflects the latest changes in your editor.

[^1]: Deploying moves the changes in your development version to your live app, so your end-users can see them.

    **Article:** [Deploying your app](https://manual.bubble.io/help-guides/publishing-your-app/deploying-your-app.md)

[^2]: The debugger lets you run your app step by step and inspect its elements and workflows while it runs.

    **Article:** [The debugger](https://manual.bubble.io/help-guides/getting-started/navigating-the-bubble-editor/tools/using-the-debugger.md)

[^3]: Privacy rules are conditions you set up on a data type to control who can find, view, and change its data.

    **Article:** [Protecting data with privacy rules](https://manual.bubble.io/help-guides/data/the-database/protecting-data-with-privacy-rules.md)

[^4]: The development version of your app, also called version-test, is where you build and test changes before they go live.

    **Article:** [Version control](https://manual.bubble.io/help-guides/maintaining-an-application/version-control.md)

[^5]: Plugins add new features to your app, such as elements, actions, and connections to external services.

    **Article:** [Plugins](https://manual.bubble.io/help-guides/integrations/using-plugins.md)

[^6]: The HTML element lets you place custom code on a page, such as HTML, CSS, or JavaScript.

    **Article section:** [HTML](https://manual.bubble.io/help-guides/design/elements/web-app/visual-elements.md#html)

[^7]: The page header lets you add custom code, such as scripts or meta tags, to the head section of a page.

    **Core reference:** [HTML header](https://manual.bubble.io/core-resources/bubble-elements/element-properties/web-element-properties/page-properties.md#html-header)
