Virality

Sharing

Finding ways to get your app in front of more users is a challenge for many developers. Here are a few ways to help you get started both inside and outside of World App.

Bringing in users from outside of World App

Getting new users to install World App and try out your app.

If the user doesn't have your mini app installed and opens the link, the path parameter will be preserved after they install and open your app. This preservation of the path parameter enables invite programs.

Meta tag images

In the developer portal, you can specify a meta tag image that will be shown when your app is shared on social platforms. If the image is not set, we fallback to your first showcase image. The updated meta tag will start showing up 1 hour after your app is approved. You can also localize these images, which allows you to translate text in the image for example.

Universal Links

You can deep link users to your mini app using universal links. Link previews currently use your first showcase image as the preview.

https://world.org/mini-app?app_id={app_id}&path={path}

Path is a url encoded path to the page you want to link to inside of your mini app. If you're having trouble try adding or removing the leading / in the path.

Traditional https links can sometimes be blocked by ad blockers and other webviews. If the user already has World App installed, you can use a deep link to open the app. However, if the user doesn't have World App installed, the worldapp:// deep link will do nothing.

worldapp://mini-app?app_id={app_id}&path={path}

Ecosystem pages can also be shared on social platforms and are set up to support both https:// universal links and worldapp:// deep links.

To force a universal link to open in an external browser rather than within a webview (if applicable), you can add the open_out_of_window=true query parameter. Using this parameter can be useful for specific user experiences where breaking out of an embedded view is desired.

Deferred Deep Links (Android)

Android has the concept of a deferred deep link where you can prompt a user who doesn't event have World App installed to install the app and then World App will remember the path you specified and direct the user to your mini app after onboarding. This deferred deep linking mechanism is extremely useful for invite campaigns.

URL Format:

https://play.google.com/store/apps/details?id=com.worldcoin&referrer=app_id%3D{app_id}%%26path%3D{path}

Make sure to url encode the app_id and path parameters.

Inside World App

Getting users already within World App to try out your app.

Quick Actions

Quick Actions enable seamless collaboration between mini apps within World App. The best apps are designed around a single core feature. If you need to offer distinct functionalities, consider creating separate mini apps that can interact with each other via Quick Actions. We also recommend using other developers' apps as a source of partnership.

Your mini apps can also be directly accessible from the home screen. Prompt users to add the widget to their home screen (ios/android) and even just pin the mini apps to their home screen (android only).

Widget on iOS

Try out the new share command to get users to share content from your mini app to others in their network easily. This command allows users to trigger the native sharing functionality of their device, making it simple to distribute links, text, or other data from your mini app. Read more here