subscription table. This page describes every field, the subscription status lifecycle, how to run migrations, and how to rename or remap fields using the schema option.
User fields
Organization fields
Whenorganization: { enabled: true } is set, the organization table also receives:
Subscription table
Thesubscription table is created only when subscription.enabled is true.
Subscription statuses
Migrations
After installing the plugin and configuring your schema, run the Better Auth CLI to generate and apply migrations.The exact migration output depends on your database adapter (Prisma, Drizzle, or others). Always review the generated migration before applying it in production.
Customizing the schema
You can rename the subscription table or remap individual fields using theschema plugin option. This follows Better Auth’s plugin schema customization convention.
auth.ts
modelNamerenames the table fromsubscriptiontobilling_subscription.- Each key inside
fieldsmaps the internal field name to your preferred column name.