Filter override applies to new subscriptions instantly, but existing subscriptions update asynchronously

When you add or modify a filter on a plan and choose the Override option, Lago pushes the change to all active subscriptions on that plan, but the update runs asynchronously as a background job. Existing subscriptions aren't updated instantly, and propagation can take minutes to an hour under high queue load. Override only adds the new filter, it doesn't reset any pre-existing subscription-level overrides on other charges.

How it works

When editing a plan filter, Lago offers two options: "Add to new subscriptions only" leaves existing subscriptions unchanged, while "Override" pushes the new filter to all active subscriptions on that plan. Override is scoped to the specific filter being added or modified. It doesn't touch custom pricing set directly on individual subscriptions or reset other existing overrides. For example, if a customer has a custom price on one charge and you add a new filter via Override, their custom price remains intact.

How to confirm the cause

After triggering an Override, check the subscription via GET /api/v1/subscriptions/{external_id} or the Lago UI and look for the new filter in the subscription's charges. If it isn't visible after 30 to 60 minutes, the background job queue may be backed up.

How to resolve the issue

No action is needed if propagation lands within the expected window. If subscriptions are still unchanged after several hours, contact Lago support to investigate the background job queue.

This article reflects guidance drawn from customer case resolutions. It is not officially supported documentation and may not apply to all situations.