Appearance
Troubleshooting
troubleshooting guide
Quick fixes for problems users hit most often in Beentara admin.
For setup context, start with Getting Started. For deep feature help, use the User Guide index.
Email or WhatsApp not sending
Symptoms: Invoice published but customer did not receive email; toast says SMTP not configured or WhatsApp delivery failed.
Email (SMTP)
- Open Profile menu → Settings (
/setting). - Expand Login Mail & Passkey — verify SMTP host, port, username, and password.
- Save and test by publishing a small draft invoice to yourself.
Draft vs Published
Draft documents are saved internally only — they are not emailed or sent via WhatsApp until you Publish.
WhatsApp (AiSensy)
- In Settings (
/setting), expand WhatsApp (AiSensy) — Billing. - Paste your AiSensy API key, account email, and Live API campaign names (invoice, quote, and optionally receipt / credit note).
- Campaigns must be API Campaigns set to Live, attached to an approved TEXT template (Interactive Actions None). Billing WhatsApp is separate from CRM messaging.
Related: WhatsApp (AiSensy) setup · Settings · Invoices — delivery options
Payment link not working (Razorpay)
Symptoms: Customer cannot pay online; pay link missing or checkout fails.
- Open Settings → expand Payment Gateway (Razorpay) (
/setting). - Enter valid Key ID and Key Secret from your Razorpay dashboard.
- Save and publish a new invoice — the pay link is generated on publish.
Also check:
- Invoice is Published, not Draft.
- Grand total is greater than zero.
- Razorpay account is active and not in test/live mismatch.
Related: Settings guide · Receipts
Permission denied
Symptoms: Menu item missing, page shows access error, or action button disabled.
| Cause | Fix |
|---|---|
| Staff account without permission | Admin grants module.read / module.create in user settings |
| Wrong account type | Staff use limited views — confirm you need admin access |
| Trial or subscription expired | Check Trial Status and Subscription |
Common permission keys: billing.read, crm.read, customers.read, products.read, settings.read.
Related: Getting Started — Permissions
Invoice stuck in Draft vs Published
| Status | Meaning | Customer sees it? |
|---|---|---|
| Draft | Saved internally | No — not sent |
| Published | Sent / live | Yes — email, WhatsApp, portal |
Fix: Open the invoice → Edit → click Publish (or Update if already published).
On the list page, use Invoice Summary → Inactive (Draft) filter to find unpublished invoices.
Related: Invoices guide
Quote not converting to invoice
- Open quote detail (
/invoice-detail/:idfor quote documents). - Click Convert to invoice (visible on approved quotes).
- Review line items on the new invoice form and Publish.
If the button is missing, the quote may still be a draft or already converted.
Related: Quotes guide
Bulk delete blocked
Symptoms: Delete selected fails; message says customer or record is linked.
| Record | Usually blocked when… |
|---|---|
| Customers | Linked to invoices, receipts, or orders |
| Products | Referenced on orders or invoices |
| Invoices | Published with payments — delete individually with care |
Fix: Archive or deactivate instead of delete where available (e.g. toggle customer/product Inactive). Remove dependencies first, then delete.
CRM reminders not notifying
- Allow browser notifications when Beentara prompts on the CRM page.
- Check Reminders tab for due items.
- Staff only see reminders for assigned leads.
Related: CRM guide
Storefront not updating
- Confirm products are Active and in stock.
- Check Themes — theme must be installed and activated (
/appearance/themes). - Clear browser cache or open storefront in incognito.
Related: Setup storefront workflow
Website page not visible or “Open live” fails
Symptoms: Custom page stays draft on the storefront; Open live asks for a website URL; homepage change has no effect.
- Publish the page from Website Pages (
/website-pages) or the editor — Save alone does not go live. - Set website link in Settings → Profile so Admin can build your storefront origin.
- For homepage (
/website-pages/homepage): pick a Published page and save; clearing selection restores the default theme home. - Add the page to Menus (
/menus) if customers should navigate to it. - AI generate failed or quota message — wait and retry, or build manually; check your plan AI limits.
Related: Website Pages · Menus · Settings
Admission public form not updating or broken
Symptoms: Parents still see an old form after you edited; Center / Batch / Plan dropdowns are empty; wrong fee; online pay missing; publish fails with a validation error; Form link disabled; duplicate-application block; payment succeeded but admission not Paid.
Skates only
Students → Form Builder exists for Skates institutes. Complete Admission setup before debugging the public form.
Form looks old after I saved
- Check the subtitle under Form Builder — if it says Saved draft · not published or Unsaved changes, parents still see the last published version.
- Click Publish (not only Save draft). Auto-save also writes a draft only.
- To drop draft work and reload live: Revert (when a draft exists).
- Test in an incognito window after publish.
Related: Form Builder — Save draft vs Publish
Dropdowns empty (center, batch, plan)
- Add data upstream — Centers → Batches → Admission Plans.
- Ensure at least one plan is active.
- Built-in Center, Batch, and Admission Plan fields load options from the server — you do not type options manually in the builder.
- If batches exist for a center, Batch is required on submit — verify batches are linked to the center parents select.
Wrong fee or no fee shown
- Open Form settings → Pricing strategy.
- Global — fees come from Admission Plans only.
- Center-wise — you must maintain Offerings; strategy and data must match.
- With Show plan selection step on, fees follow the plan (and offering) the parent picks on that step — preview the full flow.
Cannot publish (error toast)
Common validation failures:
- At least one section must exist.
- Every field needs a label; custom fields cannot use generic placeholder labels.
- Dropdown / radio fields need at least one option (except built-in plan/center/batch).
- Conditional logic references a field you deleted — fix or remove the rule.
Form link disabled or wrong URL
- Set website link in Settings → Profile (same as storefront).
- Publish the form, then open Form link — use Your website (recommended) when configured.
- Misconfigured links may show a warning in the modal — fix Profile URL before sharing widely.
Online payment (Razorpay) not offered or fails
- Form settings → Payment on public form must be Razorpay — pay online after submit.
- Configure Key ID and Key Secret under Settings → Payment Gateway (Razorpay) (Settings).
- If keys are missing, the form uses manual payment (apply now, pay offline).
- Payment captured in Razorpay but status not Paid on Admission: add the Razorpay webhook (copy URL from Form settings — events
payment.captured,payment.failed); use Sync payment on the admission row, guest track page, or My Account → Admissions when applicable.
Related: Payment link not working (Razorpay) (billing invoices use the same keys)
Parent emails or track link missing
- Settings → Profile — storefront URL must be set for Track application in emails.
- In Form settings, check notify toggles (admin on submit, parent on fee paid / approved).
- Use preview / send sample in Form settings to test to your login email.
- Check spam; confirm SMTP is configured if you rely on custom mail delivery (Email or WhatsApp not sending).
Duplicate application blocked
Expected when Duplicate applications in Form settings is not Allow multiple applications. Blocked users are sent to guest track for their existing open application. Staff overrides apply to manual add/import — not the public form.
Adjust policy or Duplicate check scope (whole institute vs center vs center+batch) in Form settings if the rule is too strict.
Intake closed but link still works
Turn off Accept new applications in Form settings to stop new submits without unpublishing. Parents may still open the URL but cannot complete a new application.
Restored wrong version or need factory reset
- History → Restore makes that snapshot live immediately — not a draft-only undo.
- Revert cancels an unpublished draft only.
- Reset defaults (canvas footer) resets fields and settings to Beentara’s template — confirm the dialog; publish afterward if you want parents to see it.
Related: Admission Form Builder · Admission list · Admission setup · Offerings
Customer portal login fails
Symptoms: Customer cannot OTP-login to portal.
- Copy the correct portal link from Invoices overflow menu (⋮) → portal link.
- Customer must use the email on file for that business.
- OTP expires — request a new code.
Related: Customer portal guide
Still stuck?
- Help & Support in admin — WhatsApp or email Beentara support.
- Check Glossary for naming confusion (e.g. Variations vs Attributes).
- Review What's new if a feature recently changed.
Frequently asked questions
Why did my invoice email fail?
Most often SMTP is not configured in Settings → Login Mail & Passkey. Configure SMTP and publish again.
Can staff delete customers?
Only if they have delete permission and the customer has no linked invoices. Admins may still see bulk delete blocked for protected records.
Where is Razorpay configured?
Profile menu → Settings (/setting) → Payment Gateway (Razorpay) accordion section.
Why does the admission form not change after I save?
Save draft and auto-save keep staff-only drafts. Parents see the form only after Publish. See Admission public form not updating or broken.