Writes return 401, reads work
The API guard does not match the middleware group. Theweb guard needs a session; Laravel’s api group never starts one.
See Authentication. For Sanctum SPAs, also hit
/sanctum/csrf-cookie and allow credentials in CORS.
Thread has no CSS
Tailwind purged the SDK classes. Add:resources/css/app.css. Rebuild the frontend.
@vitejs/plugin-react can't detect preamble
Add @viteReactRefresh above @vite(...) in the Blade layout. Exclude the published SDK from the React plugin:
Browser runs old SDK after vendor:publish
You probably added @commentify/* to optimizeDeps.include. Remove it, delete node_modules/.vite, restart Vite. See JavaScript.
core config changes do nothing
config/commentify.php still exists, so Pro skips the overlay. Merge into commentify-pro.core and delete the extra file. The installer warns on this.
Unknown commentable type
The {type} segment is not in commentables and is not a morphMap alias. Use articles, not App\Models\Article.
Comments save locally but never appear
require_approval or a spam review left is_approved = false. Check Filament Moderation Queue and Spam Log. The author still sees their own pending comment when logged in.
spam_rejected on every guest post with a link
guests.stricter_spam holds (review) or combined rules deny. That is intentional. Raise max_links, turn off stricter guest rules, or whitelist the flow with require_approval instead of deny.
Akismet / toxicity never fires
MissingAKISMET_KEY or COMMENTIFY_PERSPECTIVE_KEY makes those checkers allow. Confirm they are listed in spam.checkers and the env is loaded.
Filament Pro pages missing
RegisterCommentifyProPlugin and the free CommentifyPlugin. Pro does not auto-register from a config flag. The installer only prints a snippet.
Pins 403
You are not a moderator. ImplementisCommentifyModerator() or add the user id to badges.moderator_ids. Pins also 404 when badges.pins is false. Replies cannot be pinned.
Import command: enable guest commenting
Importers refuse to run unlessallow_guests is true. Imported authors are stored as guests.
Media 404
COMMENTIFY_MEDIA_ENABLED is false (default). Enable it and rebuild so GET ui flips features.media.
Realtime does nothing
COMMENTIFY_REALTIME is false, Echo is not on window, or the comment is still pending (pending does not broadcast). Channel name is commentify.{alias}.{id}.