Skip to main content

How do I add or edit screens on the mobile app?

Describes how to add, edit, and design the screens of the mobile app in the App Builder.

You will need the Full Write App permission to add and edit screens. With more than one organization, you need it at a campus of the organization that owns the version.

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

One Church Software comes with an app builder for customizing parts of the mobile app, including screens and menus. To add the App Builder to a subscription, open Settings & Tools (cog icon in the toolbar), select Billing, and edit the subscription to include the add-on.

A screen is one page of your app. It is made up of blocks stacked down the page, and each block is a piece of content such as a heading, a set of buttons or a list. You arrange the blocks, and the app draws them.


Screens live in a version

Every screen belongs to a version, which is a complete copy of your app design. You choose the version you are working on from the Version dropdown at the top of the builder.

  • The dropdown lists only the versions you are allowed to edit. The builder 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, every version has one owning organization. Editing its screens needs Full Write App at any campus of that organization.

  • Deleting or archiving a version, or moving it to another owner, needs Full Write App at every campus of its owner. A version that is in use cannot be deleted or archived.

  • Version settings hold the colors, loading screen, pre check-in and barcode. The app icon and home banner always come from the organization the member is viewing, not from the version.

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


The canvas

Screens are managed at Mobile App > Builder. The canvas shows every screen in the version you are viewing, drawn as a small phone, with lines running between them wherever one screen links to another. It is a map of the app rather than a list, so you can see at a glance where a member can get to from where.

Colored dots above the canvas label what each card is:

  • Home Screen - the screen the app opens on.

  • Form - a screen showing one of your forms.

  • Feature / Built-In Screen - a screen that comes with the app, such as giving or sermons.

  • Web URL - a screen that loads a web page inside the app.

  • Menu - the navigation menu.

The screen currently set as the home screen carries a Home marker beneath its card. Screens that nothing links to are gathered together under Not reachable from Home, which is a quick way to spot a screen a member has no way of opening.

The App Builder canvas showing screens linked to one another.

Add a screen

New screens are created from the canvas itself rather than from a button in the toolbar.

  1. Right-click any empty part of the canvas background.

  2. Choose + Add Screen.

    The right-click menu on the canvas with + Add Screen.
  3. Give the screen a Name. This appears in the navigation bar at the top of the screen in the app, so name it the way a member would read it.

  4. Add the blocks you want on the screen, then click Save.

Tip: The canvas carries a reminder of this. A hint along the top reads Tip: To add a new screen, right click on the background canvas.

Open, rearrange, and remove screens

Double-click a screen card to open it for editing. For everything else, click the 3-dots menu in the corner of the card:

  • Edit - opens the screen so you can change its name and its blocks.

  • Go to screen - moves the canvas to center on that screen.

  • Insert above and Insert below - add a new screen next to this one.

  • Delete - removes the screen.

Warning: Deleting a screen also breaks anything pointing at it, and a version with links to a missing screen cannot be shown in the app. Check the lines running into the screen on the canvas before you remove it, and repoint those buttons or menu items afterwards.


Designing a screen

Opening a screen brings up an editor built around a picture of a phone. What you see there is close to what a member sees, and you work directly on it.

  • Click a block to open its properties and change its wording, images, and where it goes when tapped.

  • Drag a block to move it up or down the screen.

  • Hover between two blocks and click the + that appears to slot a new block in at that point.

  • Click + Add Block beneath the last block to add one at the bottom.

The screen editor showing blocks on a phone outline.

The blocks you can add

Click + Add Block to see everything available. The list is split into two groups.

Inline blocks can be combined freely, in any order and any number, on the same screen:

  • Text - a passage of plain text. Use it for an explanation or a short description.

  • Heading - a title with an optional subtitle, used to introduce what sits below it.

  • Button Grid - buttons laid out in a grid. Every button needs somewhere to go.

  • Action Button - a single wide button, for the one thing you most want tapped.

  • Item List - a list of rows, each with text and an optional image, and each going somewhere when tapped. Row images work best square, at least 500 x 500 pixels. Other shapes are cropped to the center.

  • Carousel - images a member can swipe sideways through. Use 1200 x 675 pixels for every slide. All slides share one frame, so a slide with a different shape is shown with a blurred background around it.

  • Image List - images stacked down the screen, each able to link somewhere. Each image shows at full width and keeps its own shape, so make every image the same size for a consistent list: at least 1200 pixels wide (for example, 1200 x 675), with no blank space around the edges.

You don't need to memorize these sizes. When you pick an image for an Item List, Carousel, or Image List block, the Choose Image window shows the recommended size in a Note at the top.

Screen level blocks take over the entire screen:

  • Form - shows one of your forms. How do I design a form? explains how to build one.

  • Tabs - splits the screen into tabs, with each tab holding another screen, a form, or a web address.

  • URL - loads a web page inside the app. The address has to be reachable publicly for it to load.

Tip: The builder explains the rule where you choose the block: A Screen Level block fills the whole screen, so it must be the only block on its screen. It can't be combined with any other block. If you want a heading above a form, put the heading on a different screen that links to it.

Working with a block

Each block has a 3-dots menu along its edge:

  • Edit - opens the block's properties.

  • Copy - duplicates the block below itself, which saves setting up a second one from scratch.

  • Insert above and Insert below - add a new block next to this one.

  • Delete - removes the block from the screen.

Nothing is saved until you click Save

The screen editor holds your changes as a working copy. Blocks you add, wording you change, and blocks you delete only reach the app when you click Save. Clicking Cancel throws the whole lot away and leaves the screen as it was, which makes the editor a safe place to try something out.

Saving also checks the screen over. If a block is unfinished, the save stops and the message Please fix the highlighted errors before saving. appears, with the blocks at fault marked. A button or list item with nowhere to go, for example, reports A destination is required.

When everything checks out, a confirmation reads Successfully saved screen. and the canvas updates.

Setting the home screen

The home screen is the one members land on when they open the app. To change it, open the screen you want and tick Set as the app home screen, then click Save.

The checkbox cannot be unticked on the screen that is already the home screen, and the builder explains why: To change, make another screen the home screen. The app always needs somewhere to open, so you replace the home screen rather than remove it.

The Set as the app home screen checkbox on a screen.

A version cannot be shown in the app until it has a home screen and no links to screens or forms that no longer exist. Archived versions cannot be shown at all.


Helpful tips

  • Keep tabbed screens to four tabs where you can. From five upwards the app folds the extras behind a More tab, which puts them a tap further away.

  • Check a screen on a phone before you publish it. How do I preview my app on a phone before publishing? covers how.

  • After changing the home screen, close and relaunch the app on a phone to see the change.

  • Images are shown on phones of every size. Favor large text and clear imagery over fine detail.

Did this answer your question?