Seller Onboarding Guide

This guide walks sellers through setting up their account, configuring item types, and using the dashboard to manage notifications.

Getting Started

Accessing the Dashboard

  1. Navigate to your dashboard URL (e.g., https://app.notifito.com)
  2. Click "Sign in"
  3. Enter your email and password
  4. Click "Sign in"

Dashboard Overview

After signing in, you'll see the main dashboard with:


Managing Item Types

What Are Item Types?

Item types define the products or services you sell. Each item type has:

Creating an Item Type

  1. Click "New item type" button
  2. Fill in the basic information:
- Name: Enter a descriptive name

- Slug: Auto-generated or customize

- Call-to-action URL: Optional link to your product page

  1. Configure notification policy:
- Notify everyone who matches: All matching subscribers receive notifications

- Notify a multiple of available capacity: Limit notifications based on stock

  1. Set subscription mode:
- Notify once, then finish: Subscription ends after notification

- Keep notifying on each availability: Subscription stays active

  1. Add attributes (see below)
  2. Click "Save"

Editing an Item Type

  1. Click "Edit" next to the item type
  2. Modify any fields
  3. Click "Save"

> Note: Editing a schema creates a new version. Existing subscribers keep their original schema version.


Defining Attributes

Attributes are custom fields that describe your items. They determine:

Adding Attributes

  1. Click "Add attribute" in the editor
  2. Fill in the attribute details:
- Key: Lowercase snake_case identifier (e.g., size, color)

- Label: Display name (e.g., "Size", "Color")

- Type: Data type (see below)

- Options: For enum types, list available options

- Required: Whether consumers must provide this value

- Used for matching: Whether this attribute participates in matching

  1. Repeat for each attribute

Attribute Types

TypeDescriptionExample
enumSingle selection from optionsSize: 40, 41, 42
enum (multiple)Multiple selectionsColors: red, blue
integerWhole numberGuests: 2
decimalDecimal numberPrice: 10.5
dateDateAppointment: 2026-09-01
date_rangeDate rangeStay: Sep 1-5
booleanYes/noGift wrap: true
textFree textNotes: "Leave at door"

Attribute Options

Required: Consumer must provide this value when subscribing Used for matching: This attribute participates in matching: Allow several (enum only): Consumer can select multiple options

Example: Sneaker Store

KeyLabelTypeOptionsRequiredMatchable
sizeSizeenum40, 41, 42, 43YesYes
colorColorenumred, blue, blackNoYes

Example: Hotel

KeyLabelTypeRequiredMatchable
stayStay Datesdate_rangeYesYes
guestsNumber of GuestsintegerYesYes

Example: Clinic

KeyLabelTypeOptionsRequiredMatchable
appointmentAppointment Datedate—YesYes
practitionerPractitionerenumDr Ng, Dr Okafor, AnyNoYes

Managing Items

Items are specific instances of item types. For example:

When to Use Items

Use items when: Don't use items when:

Using the Notify Form

The Notify form allows you to manually signal availability from the dashboard.

Accessing the Notify Form

  1. Click "Notify" next to an item type
  2. The form loads with the item type's attributes

Sending a Notification

  1. Select an item (if applicable)
  2. Fill in attribute values (leave blank to notify all subscribers)
  3. Set capacity (optional)
  4. Click "Notify"

How It Works

The Notify form:

Best Practices


Understanding Notifications

Double Opt-in Flow

  1. Consumer subscribes via widget
  2. Confirmation email is sent automatically
  3. Consumer clicks confirmation link
  4. Subscription becomes active
  5. When you signal availability, matching subscribers are notified

Matching Logic

Subscribers are notified when:

Attribute Matching

SubscriptionAvailabilityResult
Size: 42Size: 42Match
Size: 42Size: 41No match
Size: (empty)Size: 42Match (wildcard)
Size: 42Size: (empty)Match (wildcard)

Notification Policies

All: Notify all matching subscribers Capacity Multiple: Notify the oldest N subscribers, where N = capacity × factor

Subscriber Status

StatusDescription
pending_confirmationWaiting for email confirmation
activeConfirmed and waiting for notification
notifiedHas been notified (once mode)
expiredSubscription expired (90 days)
unsubscribedConsumer unsubscribed

Consent Ledger

Every consent action is recorded in an append-only ledger:

This provides a complete audit trail for compliance.


API Keys

Key Types

Key TypePrefixPurpose
Publishablepk_Widget integration (safe to expose)
Secretsk_Server-to-server API calls

Using Keys

Widget (Publishable):
html
<script src="https://cdn.notifito.com/notifito.js"

data-key="pk_live_your_key"

data-item-type="sneaker">

</script>

Push API (Secret):
bash
curl -X POST "https://edge.notifito.com/v1/availability" \

-H "Authorization: Bearer sk_live_your_key" \

-d '{"item_type": "sneaker", "attributes": {"size": "42"}}'


Best Practices

Schema Design

  1. Keep attributes minimal: Only include what you need for matching
  2. Use appropriate types: Don't use text for structured data
  3. Mark non-matchable attributes: Free-text notes shouldn't affect matching
  4. Plan for changes: Schema edits create new versions; existing subscribers keep old version

Notification Strategy

  1. Set appropriate capacity: Don't over-notify
  2. Signal availability promptly: Consumers expect timely notifications
  3. Include all relevant attributes: More attributes = better matching

Consumer Experience

  1. Clear expectations: Tell consumers what they're subscribing to
  2. Confirmation flow: Double opt-in builds trust
  3. Easy unsubscribe: One-click unsubscribe in every email
  4. Relevant notifications: Only notify when truly available

Troubleshooting

Widget Not Working

  1. Check API key: Ensure you're using the publishable key
  2. Check item type slug: Must match exactly
  3. Check domain: Your domain must be registered in tenant settings
  4. Check browser console: Look for JavaScript errors

No Notifications Sent

  1. Check subscription status: Must be active
  2. Check attribute matching: Values must match
  3. Check capacity policy: May be limiting notifications

Emails Not Received

  1. Check spam folder: Confirmation emails may be filtered
  2. Check email address: Must be valid and deliverable
  3. Check confirmation status: Subscription must be confirmed
  4. Check unsubscribe status: Consumer may have unsubscribed