HOC SiteDocumentation

Notifications

In-app notifications for the platform user, plus the feedback channels that reach the platform team.

In-app notifications

Notifications belong to a platform user, not a website, and can be filtered by website. Each one has a title, a body, an optional kind, and an optional link.

  • List unread notifications, or all of them.
  • Read one notification, including its metadata.
  • Mark one as read. The response includes href when the notification links somewhere.
  • Read just the unread count for a badge.

Lifecycle actions can create a notification when an entry changes, which is how a form submission or an order reaches the right person.

Feedback

Two channels reach the platform team:

  • Bug report — what broke, how to reproduce it, and optionally the page, block ids, locale, and surface. Attaching recent request ids helps correlate server logs.
  • Feature request — what you want and why.

Both appear in the platform inbox. They are not website content.