Configure readers with a custom splash screen
Customize the default splash screen for your readers.
A splash screen is the default screen that displays when your reader is ready to accept payments. You can set a custom splash screen for these readers in one of two ways:
- In the Dashboard
- Using the Configuration API
Public preview
To set the custom splash screen for the BBPOS WisePad 3 device type in the Dashboard, you need to access this preview feature. To request access, contact Stripe support.
You can configure an account default splash screen, which applies to all readers in your fleet. You can also configure a custom splash screen for individual locations, which overrides the splash screen configured at the account level. Locations without a custom splash screen inherit the account default splash screen.
To update the splash screen, navigate to the relevant configuration you want to change and edit it. If adding a new configuration, create a new one first.
- Navigate to the Manage locations page.
- Find the specific location you want to change.
- Click the overflow menu () > Edit configuration.
- Click Edit or Override next to the Splash screen icon.
- Select the reader type (for example, S700, BBPOS WisePOS E) to indicate which reader type to apply the splash screen to.
- You can’t upload or apply a single splash screen across every reader type.
- Upload an image to display on your readers. JPG and PNG images must be less than 2MB. GIF images must be less than 4 MB. Each reader has a specific display resolution and you must crop your JPG or PNG image to fit those dimensions. GIF images scale automatically.
- Click Done.
- Apply the configuration changes by clicking Apply changes on the configuration drawer.
Note
The BBPOS WisePad 3 can only use PNG images for the splash screen. Due to hardware specifications, BBPOS WisePad 3 splash screen images are automatically converted to black and white, and repositioned slightly.
Caution
GIF files under 4 MB might still fail to upload. If this occurs, reduce the file size further by manually deleting frames. Try reducing the GIF’s frame count by 50% until the upload succeeds.
| Reader | Resolution (W x H) | Accepts GIF |
|---|---|---|
| Stripe S700 | 1080 x 1920 | |
| BBPOS WisePOS E | 720 x 1280 | |
| Verifone P400 | 320 x 480 | – |
| BBPOS WisePad 3 | 320 x 240 | – |
After uploading, save the changes and apply the configuration. For mobile readers, the splash screen updates when it’s connected to the Stripe Terminal SDK. For smart readers, the splash screen updates on the reader within 10 minutes.