Generate link previews with social metadata

You can improve the way apps and sites display your Dynamic Links by specifying social metadata when you create your Dynamic Links. This metadata is passed on to supported services in the form of social meta tags, which the services use to generate a rich presentation of the link.

For example, social apps can use the metadata to present shared Dynamic Links as cards with a title, a description of the linked content, and a preview image.

Also, the app preview page that is displayed when you open a Dynamic Link on iOS will use the metadata, if provided, to display a preview of the link's content.

Social sharing previews

Social apps can use the data specified by social metadata to generate rich previews of shared Dynamic Links. For example:

The above example is a preview of a Dynamic Link with the following metadata specified:

  • Title (st): Reticulated Giraffes

  • Description (sd): The reticulated giraffe, also known as the Somali giraffe, is a subspecies of giraffe native to the Horn of Africa.

  • Image (si): (URL to image)

The image should be at least 300x200 px, and less than 300 KB.

Social metadata is passed to Twitter, Facebook, Facebook Messenger, iMessage, WhatsApp, Google+, and other services.

App preview pages

When a user opens a Dynamic Link on iOS, they will sometimes see an app preview page that shows them which app will be used to open the link. The app preview page more reliably sends users to the most appropriate destination (such as your app) by minimizing unnecessary system dialogs and enabling users to navigate out of in-app browsers. As a result, the app preview page increases the click-to-install rate of your Dynamic Links.

If you don't specify social metadata in your Dynamic Link, the app preview page displays your app's name, icon, and description, based on your app's information in the App Store. For example:

When you provide social metadata in your Dynamic Link, the app preview page displays the title, description, and image you specified instead, as well as your app's name and icon. For example:

Send feedback about...

Need help? Visit our support page.