PHPackages                             crumbls/subscriptions-filament - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. crumbls/subscriptions-filament

ActiveLibrary[Payment Processing](/categories/payments)

crumbls/subscriptions-filament
==============================

Filament admin panel for crumbls/subscriptions — manage plans, features, and subscriptions.

v2.1.0(2mo ago)36↓93.8%1[1 PRs](https://github.com/Crumbls/subscriptions-filament/pulls)MITPHPPHP ^8.3CI passing

Since Feb 21Pushed 2w agoCompare

[ Source](https://github.com/Crumbls/subscriptions-filament)[ Packagist](https://packagist.org/packages/crumbls/subscriptions-filament)[ RSS](/packages/crumbls-subscriptions-filament/feed)WikiDiscussions main Synced today

READMEChangelog (3)Dependencies (4)Versions (6)Used By (0)

Crumbls Subscriptions Filament
==============================

[](#crumbls-subscriptions-filament)

A Filament v5 admin panel plugin for [crumbls/subscriptions](https://github.com/Crumbls/subscriptions). Manage plans, features, and subscriptions through a complete admin interface.

Requirements
------------

[](#requirements)

PackagePHPLaravelFilament`crumbls/subscriptions``2.x``8.3`, `8.4``11.x`, `12.x`, `13.x``5.x``^2.0`Upgrading from `1.x`? See [`CHANGELOG.md`](./CHANGELOG.md) for the breaking changes that came with the `crumbls/subscriptions` 2.0 bump, and the parent package's [`UPGRADING.md`](https://github.com/Crumbls/subscriptions/blob/main/UPGRADING.md) for the schema migration.

Installation
------------

[](#installation)

```
composer require crumbls/subscriptions-filament
```

Register the plugin in your Filament panel provider:

```
use Crumbls\SubscriptionsFilament\SubscriptionsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            SubscriptionsPlugin::make(),
        ]);
}
```

That's it. The plugin registers all resources automatically.

> **Note:** If you've previously run `php artisan filament:cache-components`, you'll need to clear the cache after installing:
>
> ```
> php artisan filament:cache-components
> ```
>
>
>
> Or delete `bootstrap/cache/filament/panels/*.php`.

Resources
---------

[](#resources)

All resources appear under a **Subscriptions** navigation group in your admin sidebar.

### Plans

[](#plans)

Full CRUD for subscription plans.

**List view:**

- Name, price (formatted with currency), billing cycle, subscriber count, active status
- Filter by active/inactive
- Sortable by display order
- Search by name or slug

**Create/Edit form:**

- Plan details: name, description (translatable)
- Pricing: price, signup fee, currency (USD/EUR/GBP/CAD/AUD)
- Billing cycle: invoice period + interval
- Status: active toggle, subscriber limit, sort order
- Trial period: collapsible section with period + interval
- Grace period: collapsible section with period + interval

**Relation managers:**

- **Features** — Attach existing features to the plan with a per-plan `value` (the limit). Create new features inline. Detach features without deleting them. Edit or delete features.
- **Subscriptions** — View all subscriptions for this plan. Create new subscriptions. Delete subscriptions. Status badges (Active, Trial, Grace, Canceled, Ended).

### Features

[](#features)

Standalone CRUD for features. Features exist independently of plans and can be attached to multiple plans with different values.

**List view:**

- Name, slug, number of plans using this feature, reset cycle
- Sortable by display order

**Create/Edit form:**

- Name, description (translatable), slug (auto-generated)
- Reset cycle: period + interval (set to 0 for running counts like "users")
- Sort order

### Subscriptions

[](#subscriptions)

Read-only list with management actions.

**List view:**

- Subscriber type + ID, plan name, slug, start/end dates, status badge
- Status badges: Active (green), Trial (blue), Grace (warning), Canceled (red), Ended (gray)
- Filter by plan
- Search by slug

**Inline actions:**

- **Cancel** — Cancel immediately with confirmation dialog
- **Renew** — Renew an ended (non-canceled) subscription

**View page:**

- Full subscription details and feature usage breakdown

Feature/Plan Workflow
---------------------

[](#featureplan-workflow)

The key concept: **features are defined once, values are set per-plan**.

1. **Create features** in the Features resource (e.g. "Users", "API Calls", "SSL")
2. **Edit a plan** → Features tab → **Attach** a feature
3. Set the **value** for this plan (e.g. "Users" → `10` on Basic, `50` on Pro)
4. The same feature can have different values across different plans

This is managed through the `plan_features` pivot table. The attach form prompts for `value` and `sort_order`.

Translatable Fields
-------------------

[](#translatable-fields)

Plan and feature names/descriptions support multiple locales via [spatie/laravel-translatable](https://github.com/spatie/laravel-translatable). The admin forms use the current application locale. To support multiple locales in the admin, consider a locale switcher or [filament-spatie-translatable](https://filamentphp.com/plugins/filament-spatie-translatable).

Drop-in Relation Manager
------------------------

[](#drop-in-relation-manager)

The package provides a reusable `PlanSubscriptionsRelationManager` you can add to any resource whose model uses `HasPlanSubscriptions`:

```
use Crumbls\SubscriptionsFilament\RelationManagers\PlanSubscriptionsRelationManager;

class TenantResource extends Resource
{
    public static function getRelations(): array
    {
        return [
            PlanSubscriptionsRelationManager::class,
        ];
    }
}
```

This gives you a full subscriptions tab on the resource with:

- List of all subscriptions with status badges
- Create new subscription (with plan picker)
- Cancel / Renew / Delete inline actions
- Filter by plan
- View subscription details

Works with any model — User, Tenant, Team, Organization — as long as it uses the `HasPlanSubscriptions` trait.

Customization
-------------

[](#customization)

All resources resolve model classes from `config/subscriptions.php`. If you've swapped in custom models, the admin panel uses them automatically — no additional configuration needed.

### Extending resources

[](#extending-resources)

You can extend any resource class and register your own plugin:

```
use Crumbls\SubscriptionsFilament\Resources\PlanResource\PlanResource;

class CustomPlanResource extends PlanResource
{
    // Add custom columns, filters, actions, etc.
}
```

What's Included
---------------

[](#whats-included)

ResourceActionsRelation Managers**Plans**List, Create, Edit, DeleteFeatures (attach/detach/create/edit/delete), Subscriptions (create/view/delete)**Features**List, Create, Edit, Delete—**Subscriptions**List, View, Cancel, Renew—License
-------

[](#license)

MIT

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance93

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 87.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~33 days

Total

3

Last Release

66d ago

Major Versions

1.0.0 → v2.0.02026-04-24

PHP version history (2 changes)1.0.0PHP ^8.2

v2.0.0PHP ^8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3020753?v=4)[Chase C. Miller](/maintainers/chasecmiller)[@chasecmiller](https://github.com/chasecmiller)

---

Top Contributors

[![chasecmiller](https://avatars.githubusercontent.com/u/3020753?v=4)](https://github.com/chasecmiller "chasecmiller (7 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

laraveladminsubscriptionfilament

### Embed Badge

![Health badge](/badges/crumbls-subscriptions-filament/health.svg)

```
[![Health](https://phpackages.com/badges/crumbls-subscriptions-filament/health.svg)](https://phpackages.com/packages/crumbls-subscriptions-filament)
```

###  Alternatives

[stephenjude/filament-jetstream

A Laravel starter kit built with Filament inspired by Jetstream.

17760.2k3](/packages/stephenjude-filament-jetstream)[stephenjude/filament-two-factor-authentication

Filament Two Factor Authentication: Google 2FA + Passkey Authentication

84215.9k9](/packages/stephenjude-filament-two-factor-authentication)[rawilk/profile-filament-plugin

Profile &amp; MFA starter kit for filament.

3914.6k](/packages/rawilk-profile-filament-plugin)[laraveldaily/filacheck

Static analysis for Filament projects - detect deprecated patterns and code issues

11975.6k](/packages/laraveldaily-filacheck)[maartenpaauw/filament-cashier-billing-provider

Filament billing provider for Laravel Cashier

10339.8k](/packages/maartenpaauw-filament-cashier-billing-provider)[marcelweidum/filament-passkeys

Use passkeys in your filamentphp app

6649.5k1](/packages/marcelweidum-filament-passkeys)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
