(Optional) Select target and edit configuration

Prepare a mini program version for release by completing the following actions:

• Select a target app and environment: If the default or previously chosen release targets do not meet your requirements, select a different app and environment for this release.
• Edit release-specific configuration: If you need to customize mini program runtime behavior, such as payment settings, network allowlists, or internal tester access, and the global configuration does not meet your needs, update the release-specific configuration.

Before you begin

Ensure you have the following things:

• Access: You must be either:

• Workspace admin for the workspace where the mini program was created.
• Admin for the mini program you want to release.

• Release details (if applicable):

• The target app and environment. For guidance on selecting the appropriate targets, see Release target.
• Release-specific configuration details (e.g., network allowlist and internal testers). For available configuration options and instructions, see Configuration field reference.

• Existing mini program version: The mini program version you need to release must already be created. For more information, see Create a new mini program version.

Procedure

To complete the preparation work, follow these steps:

Step 1: Navigate to the mini program version list

1. Log in to Mini Program Platform and navigate to the target workspace.
2. In the left navigation panel, click Mini Programs.
3. On the page that appears, find the target mini program in the list. You can use the search field to locate it quickly.
4. Click the name of the mini program to open its details page.
5. Click the Versions tab. You will see a list of all the created versions.

(Optional) Step 2: Select a target app and environment

Follow this step if you need to select a new target app and environment, or to edit the release-specific configuration at the same time.

1. In the version list, locate the target mini program version.
2. In the Actions column, click Select App.
3. In the dialog, select Target App (which includes the target app and environment).

Note: You can select a specific app-environment combination only once per version. If an option is unavailable (grayed out), it has already been selected previously. You can click (the plus sign) beside the version number to see existing releases and continue with your desired one.

4. Edit the fields for release-specific configuration as needed. Enter your prepared information into the appropriate fields. You can update these settings later in Step 3.
5. Click Select to save your changes.

A release record is now created for the selected app and environment, and the status for this release is set to New Version Created.

(Optional) Step 3: Edit release-specific configuration

Follow this step if you only need to provide or update the release-specific configuration for an existing release.

1. In the version list, locate the target mini program version.
2. Click (the plus sign) beside the version number to see the existing releases.
3. Locate the specific release by reviewing the Target App and Environment columns.
4. Click Configure.

(Alternatively, click Release to enter the release process page, and then select View Configuration to edit.)

5. In the dialog, edit the fields as needed. Enter your prepared information into the appropriate fields.
6. Click Save to apply your changes.

Next steps

This release is now in the New Version Created status. You can:

• Test in the target app: A temporary testing QR code is automatically generated. This QR code updates every time you change the mini program details (e.g., basic information and configuration). Scan it with the target app to see how this version of the mini program performs in the real app environment.
• Apply for release: Submit your mini program version for release to the selected target app and environment.