--- title: "User Guide: Blesta Override Price Sync" description: "Find every Blesta service with a custom price override, preview what would change, and reset or update those prices to your current package pricing. This guide covers installation, the settings, syncing and the audit log. ## Installation and setup ###…" url: "https://my.topeta.com/docs/blesta-override-price-sync/setup-guides/user-guide-blesta-override-price-sync/" updated: "2026-11-07" category: Setup Guides --- # User Guide: Blesta Override Price Sync Find every Blesta service with a custom price override, preview what would change, and reset or update those prices to your current package pricing. This guide covers installation, the settings, syncing and the audit log. ## Installation and setup ### 1. Requirements - Blesta 5.x or 6.0. - PHP 8.1 or later. - The free [Blesta Topeta Framework](https://my.topeta.com/downloads/blesta-topeta-framework/) (the `topeta_helper` plugin). It activates your license key. ### 2. Install the Topeta Framework If it isn't installed yet, follow the [Blesta Topeta Framework guide](https://my.topeta.com/docs/blesta-topeta-framework/setup-guides/user-guide-blesta-topeta-framework/) first. You only need it once for all Topeta Blesta products. ### 3. Upload the files 1. Download the plugin .zip from [Downloads & updates](https://my.topeta.com/my-downloads/) in your account. 2. Extract it into your Blesta root folder (for example `/var/www/html/blesta/`). The files go into `/plugins/override_price_sync/`. ### 4. Install the plugin 1. In Blesta, go to **Settings → Company → Plugins → Available**. 2. Click **Install** next to **Override Price Sync**. ### 5. Activate your license 1. Go to **Tools → Topeta Helper**. 2. Enter the Override Price Sync license key from [Licenses](https://my.topeta.com/licenses/) in your account and click **Save License Keys**. 3. The status changes to **Pro activated** (or **Pro trial is activated** for a trial key). ### 6. Upgrading 1. Extract the new .zip over the existing files. 2. Go to **Settings → Company → Plugins → Installed** and click **Upgrade** next to Override Price Sync. ## Opening the plugin - **Tools → Override Price Sync**, or - **Settings → Company → Plugins → Installed → Manage** next to Override Price Sync. ## Settings Click **Save Settings** after changing anything. The preview and every sync use the saved settings. ### Price Adjustment Method - **Clear Override Price Completely**: removes the custom price and its currency from the service. Future renewals use the standard package price. - **Set Override Price = Current Standard Package Price**: sets the custom price to the package's current renewal price, in the service's currency. ### Price Change Direction - **All Price Changes**: services whose new price is higher or lower. - **Price Increases Only**: only services where the standard price is higher than the custom price. - **Price Decreases Only**: only services where the standard price is lower than the custom price. ### Exclusions - **Excluded Packages**, **Excluded Package Groups** and **Excluded Client Groups**: select one or more. - **Excluded Clients**: client IDs separated by commas, for example `104, 215, 309`. ### Package edit automation When **When a package is edited, automatically sync the overridden services on that package** is on, saving a package syncs the overridden services on that package only, using your saved settings. ## Preview and sync 1. Save your settings, then click **Preview Affected Services (Dry Run)**. 2. Check the **Services With Price Overrides** table: client, service, package, current override price, new standard price, price difference (green for an increase, red for a decrease) and term. Prices are shown in the service's currency. A ⇄ icon means the package has no price in that currency for the term, so the price was converted with your Blesta exchange rates. 3. Tick services and click **Sync Selected Services**, or click **Sync All Filtered Services** to change every service in the table. Only active and suspended services are included. Existing invoices are never changed. ## Scheduled sync (optional) The **Sync Override Service Prices** automation task is installed switched off, so nothing changes until you decide. 1. Make sure the preview with your saved settings shows exactly what you want changed. 2. Go to **Settings → Company → Automation**, find **Sync Override Service Prices** and click **Edit**. 3. Enable it and choose a time, for example daily at 00:00. ## Recent changes (audit log) The **Recent Changes** table on the plugin page shows the last 25 changes: date, client, service, old price, new price and what triggered the change (a manual sync and the staff member, the scheduled task, or a package edit). To undo a change, open the service in Blesta and set the price shown as **Old Override Price**. ## Licensing - **Valid license or trial**: everything works. - **Lifetime license with expired updates**: everything keeps working; only updates and support need renewal. - **Missing, invalid or expired trial license**: the plugin page shows a warning, and syncing, the scheduled task and package edit automation do nothing. The preview still works so you can audit your prices. On a Blesta installation with several companies, install the plugin and enter the key in each company that uses it. ## Troubleshooting ### No services show in the preview Only active or suspended services that have a custom price are listed. Check that your exclusions or direction filter aren't hiding them, and that you saved the settings. ### The sync says a license is required Install the Blesta Topeta Framework, enter your key under **Tools → Topeta Helper** and save. If you saved the key before installing this plugin, save it again. ### The scheduled task isn't doing anything It's installed switched off. Enable it under **Settings → Company → Automation** and check the license status. ### Prices in the preview look converted The service has a custom price in a currency the package has no price for, for that term. Add a price in that currency to the package if you want an exact amount. Still stuck? [Open a support ticket](https://my.topeta.com/support-portal/).