Skip to main content
checkins help showcase real-world activity at your lounge or retail location. The Boxpressd Sites SDK includes components that make it easy to display recent customer visits and community engagement directly on your website. All checkin components automatically use the business context resolved by the BoxpressdProvider.
checkins are primarily a venue-focused feature. Some components may return no data for business types that do not support checkins.

Available Components

BoxpressdCheckinsFeed

The feed component displays recent customer activity for the active venue.

Example

Props

List Layout

Grid Layout

BoxpressdCheckinCard

Display a single checkin. This component is useful when building custom activity feeds or combining checkins with other content.

Example

Props

checkin Object

Username Normalization

The SDK automatically generates a display name using the following fallback order:
This allows activity feeds to remain user-friendly while respecting privacy settings.

Example: Homepage Activity Feed

Example: Sidebar Widget

Example: Community Section

Styling

checkin components inherit Boxpressd theme variables.

Custom Styling

Business Awareness

checkin components automatically use the resolved business context.
No venue IDs or business IDs are required. The SDK automatically determines which venue’s activity should be displayed.

Empty States

Some venues may have little or no recent activity. Components should gracefully handle empty results.

Common Use Cases

Homepage Social Proof

Show visitors that customers actively visit the location.

Community Page

Create a dedicated community section highlighting customer engagement.

Lounge Dashboard

Display recent visitor activity.

Privacy Considerations

checkin components are designed for public-facing websites. The SDK automatically:
  • Uses normalized display names
  • Avoids exposing sensitive user information
  • Respects visibility settings where applicable
Developers should avoid displaying private user data outside of the information returned by the SDK.

Best Practices

  • Keep activity feeds recent and concise.
  • Display 5–10 items on homepages.
  • Use larger feeds on dedicated community pages.
  • Combine checkins with events and reviews for stronger social proof.
  • Gracefully hide the section when no activity exists.

Next Steps

Continue to:
  • Sessions
  • Reviews
  • Events
  • Data Fetching → checkins
These guides cover additional engagement and community-focused features.