Sign in →
Embed Widgets1 min read

Embed Widgets: Coming Soon

PaymentMethod — the last widget whose body lands in a subsequent minor release. Public API is locked today. SubscriptionManager, UsageMeter, and UpgradeCancel have shipped — see their dedicated pages.

Updated 2026-06-15Suggest edits
Docs Embed Widgets Coming Soon

Why we published the shells#

Four of the eight planned widgets ship as shells in v0.1.x — they render an accessible loading placeholder while their bodies are being built. Their public API (props + events) is by the SDK contract test, so dropping in the real body later requires no code changes on your side.

INFO
Today, mounting one of these widgets renders a 80px-tall placeholder with role="status" and aria-busy="true", themed with your brand kit. The placeholder is structurally correct so layout decisions you make today will hold when the real body lands.
PRO TIP
SubscriptionManager and UsageMeter shipped in v0.7.0 and UpgradeCancel shipped in v0.8.0 — see the , , and pages for the live API.

PaymentMethod (planned)#

Saved payment methods table with add/remove flow. Card masking (last 4 + brand icon), primary-card indicator, add-new-card iframe (Stripe Elements / Razorpay Drop-in), delete confirmation dialog.

future-shape.tsx
<AforoPaymentMethod
  tenantSlug="acme"
  embedKey="embk_live_…"
  bridgeToken={token}
  showAll={true}            // (planned) — list all saved methods (default: only primary)
  allowAdd={true}           // (planned)
  allowDelete={true}        // (planned)
/>

When will these ship?#

Each widget ships as a dedicated minor release. The schedule is driven by customer signal — the widget with the most pre-launch demand ships first. The public API stays locked across minors, so a future 0.x release ships a real PaymentMethod body without changing your prop interface.

After the remaining two bodies ship, the SDK promotes to 1.0.0 with a frozen v1 public surface and a 90-day deprecation period for any future breaking changes. See the for the full policy.

PRO TIP
Need one of these widgets sooner? Email support@aforo.ai with your use case. We prioritize the body roadmap based on customer demand.