Information
This page is not available in Chinese yet.

# Adding a LIFF app to your channel

When you add a LIFF app to a LINE Login channel on the LINE Developers Console, the LIFF app can run either in LINE or in an external browser.

# Before you begin

Make sure you've done the following:

# Using share target picker

When using the share target picker liff.shareTargetPicker() in the LIFF app, developers should carefully read and agree to the Agreement Regarding Use of Information content. This agreement is required for each channel.

  1. In the LINE Developers Console, select the LINE Login channel to which you want to add the LIFF app and click the LIFF tab.

  2. Click shareTargetPicker, carefully read the displayed contents and check I have read and agree to the Agreement Regarding Use of Information, then click Enable.

# Adding the LIFF app to your channel

You can add up to 30 LIFF apps to each channel.

  1. On the LINE Developers Console, select the LINE Login channel to which you want to add the LIFF app, then click the "LIFF" tab.

  2. Click Add.

  3. Concatenate the following items in the order listed:

    Basic information

    Item Description
    LIFF app name Name of the LIFF app
    Size Size of the LIFF app view. Select one of:
    • Compact
    • Tall
    • Full

    Endpoint URL The URL of the LIFF web app (e.g. https://{Heroku app name}.herokuapp.com). This URL will be used when the LIFF app is launched using the LIFF URL.
    The URL scheme must be https. URL fragments (#URL-fragment) can't be specified.
    Methods for converting additional information in the LIFF URL *1 Specify how to handle the paths (/path) and query parameters (?key=value) added to the LIFF URL when launching the LIFF app using the LIFF URL. For more information, see Opening a LIFF app.
    Scopes Scope required for the LIFF app to function.
    • openid: Required to obtain the ID token. *2
    • email: Required to obtain the user's email address. *2
    • profile: Required to obtain the user's profile information.
    • chat_message.write: Required to send a message on behalf of the user. Depending on your account type, this option may appear under View all.
    Bot link feature *3 The setting for bot link feature
    • ON (normal): Adds the option to add the LINE Official Account as a friend on the consent screen.
    • ON (aggressive): Displays a screen which confirms if the user wants to add the LINE Official Account as a friend after the consent screen.
    • OFF: Doesn't display the option to add the LINE Official Account as a friend on the consent screen.

    Options

    Item Description
    ScanQR Enable this setting when using a QR code reader in the LIFF app.
    Module mode Enable this setting when using the LIFF app in module mode. When Module mode is enabled, the share button in the header is hidden.

    *1 Not Displayed when adding the LIFF app. Displayed only when editing.
    *2 Displayed only if you applied for OpenId Connect email permission in a LINE Login channel.
    *3 Displayed only for a LINE Login channel.

  4. Click Add.

    When adding the LIFF app, a LIFF ID and LIFF URL are created.

    Item Description
    LIFF ID LIFF app ID.
    For example: 1234567890-AbcdEfgh
    LIFF URL The URL to access to LIFF apps. When users access the LIFF URL, they are redirected through the LIFF server provided by LINE to the LIFF app server (endpoint URL) provided by the developer.
    For example: https://liff.line.me/1234567890-AbcdEfgh

# Other operations

You can also perform these operations from the LIFF tab of the LINE Developers Console.

  • Edit LIFF app settings
  • Delete the LIFF app from your channel

# Next steps

After adding the LIFF app to your channel, try opening it.