Alipay International Mini Program Development PlatformAlipay International Mini Program Development PlatformDOCS

Add features

Add features to access specific JSAPIs and enable new capabilities for your mini program.

Before you begin

Ensure the following things:

  • Have required access: You must be either:
    • Workspace admin for the workspace where the mini program was created.
    • Admin for the mini program you want to configure.
  • (Recommended) Know your desired features: Know the names of the features you need to add. This helps you locate them quickly.
  • Understand update behavior: Applying the newly added features might require creating a new version of your mini program. For details, see How changes take effect.

Procedure

To add features to your mini program, take the following steps:

Step 1: Open the mini program details 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.

Step 2: Add features

  1. On the mini program details page, click the Features tab.
  2. Click Add Features. The Add Features dialog opens, displaying all available features.
  3. Review the feature list. Use the following information to help you decide:
    • Name: The unique, descriptive name of the feature.
    • Version: The current released version.
    • Description: Explanation about the feature's functions and typical use cases.
    • Activation Required: Whether the feature requires approval from the super app before use.
    • Activation Status: The current status of a feature that requires approval. Possible statuses include:
      • Activated: Approved and ready to be added.
      • Applying: Approval requested. The feature can be added once approved.
      • To be activated: Approval has not yet been requested. You must apply to add this feature.
  1. (Optional) If a feature requires activation and shows a To be activated status, take the following steps to activate it:
    1. Click Activate in the Action column.
    2. A new tab will open. Review the feature details and click Apply for activate.
    3. In the dialog that appears, review your request details and the Agreement Document.
    4. Select the checkbox to agree to the terms and click Apply to submit your request.
    5. Once your request is approved, return to the Add features dialog and refresh to proceed. You can check the review status:
      • In the platform, via the My Request menu.
      • Your account's email inbox. The result is sent once the super app completes the review.
  1. Select the checkboxes beside the features you need. If some features are pending activation, choose either of the following options:
    • Add features that do not require activation or that are already activated first, then add pending features later after they are approved.
    • Wait for approval of the features that are pending activation, then add all desired features at once.
  1. Click Add or Next (the button label depends on your mini program type). Then, proceed based on the button you click:
    • If you click Add (for DSL mini programs), proceed to Step 4.
    • If you click Next (for H5+ mini programs), proceed to Step 3.

(Optional) Step 3: Save the changes

This step varies based on the status of your mini program. Follow the instructions based on the prompt you see:

  • If you see a simple confirmation dialog:
    • When this occurs: The latest version of the H5+ mini program in all target apps is New Version Created.
    • What to do next: Click Save.
  • If you are asked to create a new version:
    • When this occurs: The latest version of the H5+ mini program in any target app has a status other than New Version Created.
    • What to do next: Configure a new mini program version as follows:
      1. Review or change the version number
        1. Check the New Version field, whose value uses the major.minor.patch format. The field is pre-filled with a suggested version that increments the patch number by 1 (for example, 1.0.1 if the latest version is 1.0.0).
        2. If needed, change the version number. You can follow Semantic Versioning guidelines to assign one.
      1. Select a next step
        • Click Save to create the new version. This will add it to the Versions tab for later action.
        • Click Save & Publish to create the new version and start the release process for this version. For release instructions, see Release a mini program.

Step 4: Verify success

A success message appears. Your newly added features will show in the list on the Features tab.