Skip to main content

How do I preview my app on a phone before publishing?

Describes how to preview an unpublished app version on a phone using a preview code.

You will need the Full Write App permission to start a preview.

Your One Church Software subscription also needs the App Builder add-on to access this area.

The builder shows you a drawing of each screen, which is close to the real thing but not the real thing. Live Preview loads a version onto an actual phone so you can tap through it the way a member would, without making it live first.

Anyone with the One Church app on their phone can open a preview. They do not need access to One Church Software, and they do not need to be signed in to your church to see the design.


Starting a preview

Previews are started from Mobile App > Builder. Select the version you want to look at in the Version dropdown, then click Live Preview.

The dropdown lists only the versions you are allowed to edit, and opens on the base version, or on the first version in the list if you cannot edit the base. If your account has two or more organizations, you may not be able to open the version some members actually get.

A panel opens with a QR code, a code you can type, and a countdown. The version being previewed is named under the code, so you can confirm you picked the right one before you hand the code to anybody.

The Live Preview panel with a QR code, a typed code and a countdown.

Open the preview by scanning the code

This is the quickest route when the phone is in your hand. The panel lists the steps:

  1. Point your phone's camera at the QR code.

  2. Tap the link that appears to open the One Church app.

  3. Wait for the version to load. Any edits you make in the builder appear on the phone right away.

If the One Church app is not on the phone yet, the link sends you to the app store first. Install the app, then scan the code again.

Open the preview by typing the code

Use this when the phone is not in front of the screen, for example when you are sending the code to a staff member in another building.

  1. Click Copy beside the code in the Live Preview panel and send it to the person who is previewing.

  2. On the phone, open the One Church app and go to Settings > App Builder > App Preview.

  3. Enter the eight-character code and confirm.

The App Preview screen in the One Church app where the code is entered.

While the preview is running

A banner across the top of the app names the version being previewed, so nobody mistakes a preview for the real app. A status dot beside it shows whether the phone is still connected to the builder.

The preview is live rather than a snapshot. Save a change in the builder, and it appears on the phone within a moment, which makes this a good way to review wording and images with someone standing next to you.

To leave the preview and go back to the live app, tap Exit in the banner.


What the preview does not show you

A preview shows the one version you picked. What a member actually sees can differ:

  • Members may get a different version. A signed-in member sees the version for their Campus Attended when that campus is in the organization they are viewing, otherwise that organization's version, otherwise the base version. A guest sees the organization's version, otherwise the base version.

  • Organization and campus versions need an App Builder seat. If an organization has no seat, its members see the base version, whatever the preview shows.

  • The version must be ready to show. A version needs a home screen and no links to missing screens or forms before it can be shown, and an archived version cannot be shown at all. Previewing an archived version shows something no member will get.

  • The icon and home banner come from the organization. They belong to the organization the member is viewing, not to the version, so the preview may show a different icon from the one members see.

How do versions and publishing work in the App Builder? explains how versions are made live.


Preview codes

Codes expire after two hours

The countdown in the panel shows how long the current code has left. Once it runs out, the code stops working and anyone using it sees a message saying the preview has expired.

Click New code to replace the code with a fresh one. The old code stops working at that moment, so anyone still previewing on the old code needs the new one.

Treat codes as private

Warning: A preview code opens a version that is not live. Anyone you send the code to can see work in progress, including screens and wording you are not ready to show members. Send codes only to the people reviewing the design.

When a code does not work

  • The code has expired - the two hours have run out, or someone clicked New code. Open Live Preview again and share the current code.

  • The version no longer exists - the version being previewed was deleted while the preview was open. Pick a version that still exists and start a new preview.

  • The code belongs to a different church - the app checks that the code matches the church the phone is set up with. A code from another church's builder will not open.

Did this answer your question?