(Optional) Go live

Go live with your mini program to make it available to its target users. You can perform either a grayscale release to roll out gradually, or a full release for immediate availability.

Note: Use this guide only for production releases. Releases to development, test, or sandbox environments are processed automatically once you complete the previous steps.

Before you begin

Ensure you meet the following prerequisites:

  • 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 status: The release status must be either Release Preparation or Grayscale Release. To achieve this status, you must have already completed the following tasks:
  • Release type: Choose a release type that best fits your needs. For more information, see Release types.

Procedure

To make your mini program version go live, take the following steps:

Step 1: Navigate to the release progress page

  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, and locate the target mini program version from the list.
  6. Click plus (1).png (the plus sign) beside the version number to see the existing releases.
  7. Locate the specific release by reviewing the Target App and Environment columns.
  8. Click Release.

Step 2: Choose a release type and execute

Follow the instructions based on your preferred release type.

Perform a grayscale release

To perform a grayscale release, take the following steps:

  1. On the release progress page, select Grayscale Release as the release type and click Confirm.
  2. In the Grayscale field, select the initial percentage (for example, 1%) of users who can access the new version.
  3. Click Next Step to begin the release.
  4. Based on user feedback, manage the grayscale release as follows:
    • If user feedback is positive, follow these steps to increase the rollout until you reach a full release:
      1. Return to the release progress page.
      2. Select a higher grayscale percentage. Note that setting the percentage to 100% completes the grayscale process and performs a full release.
      3. Click Next Step.
    • If user feedback is negative, follow these steps to cancel your release:
      1. Return to the release progress page.
      2. Click Cancel Grayscale.
      3. In the confirmation dialog, click Confirm.

This action terminates both the grayscale release and the release process, changing the release status to Canceled. To release the mini program again, improve your mini program to address the issues, create a new version, and release the new version. For release instructions, see Release a mini program.

Tip: To reset the release type or percentage, click Reset. This reverts the mini program to 0% release, allowing you to start over.

Perform a full release

To perform a full release, take the following steps:

  1. On the release progress page, select Full Release as the release type.
  2. Click Confirm to immediately make your mini program available to all users.

Next steps

After your mini program is fully released, you can manage it with the following actions:

  • Generate QR codes: Create QR codes for your mini program pages to share and promote your mini program through various channels.
  • Take mini program offline: Take your mini program offline from the target app to discontinue your service.