Home Screen Widgets

Display passes and barcodes directly on your home screen

2 min read

Home Screen widgets show live information from NeatPass without opening the app. View your upcoming event, see barcodes at a glance, or tap to quickly scan new tickets.

Widget Types

Pass Display

Shows your upcoming pass or a specific pass you choose.

Quick Action

One-tap camera icon to scan a new ticket.

Available Sizes

Small (2x2)

Pass name, date, and color. No barcode. Tap opens pass in app.

Medium (4x2)

Full name, date, venue, and scannable barcode.

Large (4x4)

Complete details, location, map preview, and large scannable barcode.

Adding Widgets

1

Enter edit mode

Long-press on your home screen until icons wiggle.

2

Open widget gallery

Tap the + button in the top-left corner.

3

Search NeatPass

Type "NeatPass" in the search bar.

4

Select widget

Tap Pass Display or Quick Action.

5

Choose size

Swipe left/right to browse sizes.

6

Add and position

Tap Add Widget, drag to desired location, tap Done.

Configuring Pass Display

1

Long-press widget

Long-press the Pass Display widget.

2

Edit Widget

Tap Edit Widget from the menu.

3

Choose mode

Select Next Upcoming (automatic) or Specific Pass (manual).

Next Upcoming Mode

Automatically shows your soonest future event. After the event passes, switches to the next upcoming. If no future events exist, shows the most recently passed event.

Specific Pass Mode

Always shows the pass you select. Useful for pinning important events or passes without dates.

Barcode Tips

Scanning tips

Increase screen brightness for best scanning. Larger widget = larger barcode = easier scanning. Tap the widget to open the full-screen barcode in the app if needed.

See supported barcodes for all compatible formats.

Troubleshooting

Widget shows 'No Passes'

Open NeatPass and verify passes exist. Wait a few seconds for sync, then check the widget again.

Widget shows wrong pass

Long-press widget → Edit Widget. Check pass dates or switch to Specific Pass mode.

Widget not updating

Open NeatPass to force immediate sync. If still stuck, remove and re-add the widget.

Barcode not scanning

Use Medium or Large widget size. Increase screen brightness. Tap widget to open full-screen barcode in app.

Widget appears blank

Remove the widget (long-press → Remove Widget), open NeatPass, then re-add the widget.

Placement Ideas

User TypeRecommended Setup
Single eventOne Medium widget on main home screen set to "Next Upcoming"
Frequent travelerLarge widget for current boarding pass plus Quick Action for scanning
Event enthusiastMultiple widgets set to Specific Pass for different upcoming shows

Related

See lock screen widgets for quick-glance access. Learn about Control Center integration for fast scanning. Check the widgets overview for all options.