All Products
Search
Document Center

Microservices Engine:Update a custom plug-in version

Last Updated:Mar 11, 2026

After you enable a custom WebAssembly plug-in on a cloud-native gateway, the plug-in becomes read-only and cannot be edited directly. To apply changes to plug-in logic without disabling the plug-in, release a new version and switch to it.

Prerequisites

Before you begin, make sure that you have:

Release a new plug-in version

  1. Log on to the MSE console and select a region in the top navigation bar.

  2. In the left-side navigation pane, choose Cloud-native Gateway > Gateways. On the Gateways page, click the name of your gateway.

  3. In the left-side navigation pane, click Plug-in Marketplace.

  4. On the All Plug-ins tab, click the Custom subtab.

  5. Click the Three dots icon on the plug-in card and select Release New Version.

  6. In the Release New Plug-in panel, configure the following parameters and click OK.

    ParameterDescription
    Plug-in NameA unique name for the plug-in.
    Plug-in DescriptionA description displayed on the plug-in card.
    WebAssembly LanguageThe programming language used to develop the plug-in.
    WebAssembly FileThe compiled .wasm binary file. Upload the file from your local machine.
    Configuration VerificationThe fields and expected values to verify when the plug-in starts. If the plug-in does not require configuration, leave the code editor blank.
    Plug-in Execution StageThe processing phase for the plug-in. Stages run in the following order: Authorization > Authentication > Statistics > Default. Select Default if the plug-in has no ordering dependency on other plug-ins.
    Plug-in Execution PriorityThe priority within the selected stage. A higher value means higher priority. Keep the default value if ordering does not matter. For custom values, use multiples of 10.

Switch to the new version

After the new version is released:

  1. Click the plug-in card to open its details.

  2. On the Plug-in Configuration tab, select the destination version.

  3. Click Update Version.