Built-in Screens
Create, customize and delete the in-app screens your Rules show: promo offers, cancellation surveys, free-text feedback, URL buttons and messages.
Built-in screens are the in-app screens a Rule shows when it fires: a promo offer, a cancellation survey, a feedback form, an announcement.
Some Rule templates have just one screen associated, while others have several.
You customize them in the Edit screen editor, no code required.
Open the editor
How you open the editor depends on the rule template:
- The screen is preselected by the template. In some templates (for example, Cancellation survey or Billing issue notification) the in-app action is already set to a built-in screen. You can't switch the action, you can only edit the proposed screen: click the pencil icon next to it.
- You choose the screen. In other templates (for example, Manual rule or Win back lost subscribers), set Presentation model to Built-in Screen, then add a screen. To create one, click Add new under Create new promo offer screen, pick a template and customize it. Screens you created earlier appear under Select from existing screens, so you can reuse them in other rules. To edit the selected screen, click the pencil icon next to it.
The editor
The preview is on the left. Use the device icons above it to check the screen on different device sizes. The settings are on the right, and Save is at the top.
The General tab holds the screen name, background (image and color) and font family. The Content tab holds the blocks of the screen. Each block can be expanded or collapsed. Which blocks you see depends on the screen type.
What you can change
Every screen is built from blocks. Depending on the screen type you can:
- Text (title, description, question, heading, legal text): edit the text, font, color, size, style (bold, italic, underline, strikethrough) and alignment.
- Images (image, logo, the dismiss button icon, background): upload your own or remove it.
- Buttons (purchase button, answer options, URL button, Send): set the label, colors, font and style, border radius, and choose what happens on tap.
- Input (free-text feedback): placeholder, colors, size, style and alignment.
- The screen itself: name, background image and color, font family.
- Raw CSS: edit the CSS for anything the settings don't cover.
- Hiding blocks: some blocks (for example Image, Title, Description and Information on a promo screen) have a Hide block button. A hidden block disappears from the screen but keeps its settings, and the button turns into Show block. The dismiss button and the purchase button can't be hidden.
What happens on tap
The dismiss button and the answer options have an On tap setting:
- Dismiss screen: closes the screen. For answer options: Save answer and dismiss.
- Present another screen: shows a different screen instead of closing. Pick it under Select screen to present. The list shows the screens you've already created. For answer options: Save answer and present another screen.
The purchase button starts the purchase of the product you attach to it. Under Select a product, either keep Standard product price and pick a product, or switch to Promotional offer price, pick the product and enter the Promo offer ID. The screen closes once the purchase succeeds. A URL button opens its link.
Show several screens in a row
Use Present another screen to chain screens. For example:
- a cancellation survey that shows a promo offer after the user answers;
- a dismiss button that shows a last-chance offer instead of closing the screen.
Languages
Use the language selector at the top of the editor to switch between the languages configured for your app in App settings → Localization. You can enter different text for each language by hand, or ask AI to fill in all the configured languages for you. Review the AI result: translations can miss tone and product-specific terms.
Screen Types
Promo offer screen
| Block | What you can set |
|---|---|
| Dismiss button | Image; On tap action (for example, Dismiss screen) |
| Image | Image; Hide block |
| Title, Description | Text, font, color, size, style (bold, italic, underline, strikethrough), alignment; Hide block |
| Purchase button | Button title 1 and 2, font, style, border radius, background and text color; Select a product: Standard product price (pick a product) or Promotional offer price (pick a product and enter the Promo offer ID) |
| Information | Legal text and its style; Privacy policy and Terms of use link titles and URLs; links color; Hide block |
| Raw CSS | Edit the screen's CSS directly |
Billing issue screen
Content tab: Dismiss button (image, On tap action); Image (image; Hide block); Title and Text (text, font, color, size, style, alignment; Hide block); Button (title, font, style, border radius, background and text color); Raw CSS.
The button’s action is set by the template and can’t be changed: when the user taps it, the screen closes and the app opens the store. On iOS it opens the Apple ID billing page, on Android the app’s subscriptions page in Google Play. See Reduce Involuntary Churn for the full setup.
Cancellation survey screen
Content tab: Dismiss button, Image, Question (text, font, color, size, style, alignment) and Answer options. Each option has its own text, font, style, border radius, background and text color. Click Add option to add more. Raw CSS is available too.
On tap for an answer option:
- Save answer and dismiss: saves the answer and closes the screen.
- Save answer and present another screen: saves the answer, then shows the screen you pick under Select screen to present (the list shows your existing screens).
Free-text feedback screen
Used for open answers, for example Refund requested feedback.
Content tab: Dismiss button; Question (text, font, color, size, style, alignment); Input (placeholder text, font, placeholder and text color, size, style, alignment); Button (title, for example Send, font, style); Raw CSS.
Screen with URL button
A screen with one button that opens a link. Use it to send users to another app, the App Store page of a different app, or a web page, for example when you move your audience to a new app.
Content tab: URL (the link the button opens), Dismiss button (image, On tap action), Logo (image), Heading and Subheading (text, color, size, style) and Button. For the button choose Apple's download button or Custom button, turn Animation enabled on or off, and set icon, label, label size, height, width, text color and background color. Raw CSS is available too.
In-app message screen
A short message with a logo, heading and description. Use it for announcements, for example a maintenance notice or a promo of a new feature.
Content tab: Dismiss button (image, On tap action), Logo (image), Heading and Subheading (text, color, size, style) and Raw CSS.
Where answers go
Choice answers and free-text answers appear in the rule's Analytics tab: see Built-in Screen statistics and Feedbacks.
Delete a screen
To delete a screen you no longer need, use the delete icon on its card under Select from existing screens and confirm. Deleting can't be undone.
A screen that is still used by a rule can't be deleted: Apphud lists the rules that use it, so remove the screen from them and try again.
Adding and deleting screens requires write access to Rules.
Updated 5 days ago