Skip to main content

FAQ and Troubleshooting

This page answers the most common questions about Better Bulk Price and provides a quick diagnostic path for installation, campaign, notification, and execution issues.

Frequently Asked Questions​

Does Better Bulk Price change existing invoices?​

No. Better Bulk Price is designed for future-facing service price changes. If a renewal invoice has already been generated for the current cycle, the module does not silently rewrite that invoice.

What can a campaign target?​

In the current release, campaigns target WHMCS services only. Domain pricing and addon pricing are outside the scope of this version.

Can I preview a campaign before making it final?​

Yes. Draft campaigns can be previewed against live service data before approval.

What happens when I approve a campaign?​

Approval freezes the target snapshot for the campaign. From that point forward, the campaign works from the approved target list instead of recalculating a different live service population later.

Does client acknowledgement block the price change?​

No. In the current release, acknowledgement is non-blocking. It is recorded for transparency and support review, but it does not automatically prevent a scheduled update.

How are clients informed?​

Providers can use two main channels:

  • Client area notices.
  • Email notifications sent through WHMCS.

Can a campaign be cancelled?​

Yes. Draft and approved campaigns can be cancelled. Cancellation prevents future execution while preserving the operational history for review.

What happens if some services cannot be updated yet?​

If a service is no longer eligible for the current billing window, the module can defer it instead of applying the new recurring amount immediately.

Troubleshooting Installation​

The module does not appear in Addon Modules​

Check the following:

  1. The folder is uploaded to modules/addons/betterbulkprice/.
  2. The main module file is present and readable.
  3. The deployment package was extracted correctly and not nested inside an extra directory level.

Activation fails​

Common causes include:

  • Incorrect file placement.
  • Missing PHP compatibility requirements.
  • Database permissions that prevent table creation.

First confirm the requirements in Requirements, then review the WHMCS activity log and server error log for activation errors.

Admin users cannot access the module after activation​

Open the addon configuration page and verify that the correct admin roles were granted access.

Troubleshooting Campaign Setup​

Preview returns no matching services​

Review the selected filters carefully. The most common causes are:

  • Wrong product selection.
  • Wrong currency.
  • Billing cycle mismatch.
  • Service status mismatch.
  • An exact current recurring amount filter that is too restrictive.

Approval fails unexpectedly​

Approval can fail if no services match at approval time, even if an earlier preview had results. Preview uses live data, so the eligible population may have changed before approval.

The wrong services were included​

Do not try to reinterpret the approved campaign. Cancel it and create a new campaign with corrected filters.

Troubleshooting Notifications​

Clients do not see a notice yet​

Confirm these points:

  1. The campaign was approved.
  2. An announcement time was configured.
  3. The announcement time has already been reached.
  4. The WHMCS daily cron has run.

Email notifications were not delivered​

Check:

  1. WHMCS mail configuration is working normally.
  2. The campaign announcement time has passed.
  3. The daily cron has run.
  4. The campaign notification records show whether delivery failed.

If WHMCS email delivery is failing for other messages as well, solve the underlying mail transport issue first.

Troubleshooting Execution​

The campaign was approved but prices did not change yet​

Check the following in order:

  1. The effective time has already been reached.
  2. The WHMCS daily cron ran.
  3. The campaign targets were eligible for the current billing window.

Some services may be deferred when the current renewal invoice has already been generated.

Some services changed and others did not​

This usually indicates mixed eligibility across the approved target set. Review the campaign execution details for deferred items, failed items, or other recorded outcomes.

A client says the next invoice still has the old price​

If that invoice was generated before the service became eligible for the campaign, the old amount can still appear on that invoice. Better Bulk Price does not silently reprice invoices that were already generated.

When to Contact Support​

Contact Mimir Tech support when:

  • Activation fails and logs do not make the cause clear.
  • Notifications or cron-driven execution are not running as expected.
  • Campaign outcomes appear inconsistent with the configured filters.
  • You need help validating a production rollout.

Support: https://mimirtech.co/support