We've published a document that summarizes how to get user profile information
2024/12/18

We've published Get user profile information in the LINE Platform basics.

With the Messaging API, the LINE Login, the LINE Front-end Framework (LIFF), and the LINE MINI App, you can obtain user profile information. The types of profile information that can be obtained depend on the method used to obtain it. In addition, there is profile information that requires a separate application or contract in order to obtain, such as a user's email address and address.

The Get user profile information guide we've just published explains which profile information can be obtained using which methods in a list format.

We'll continue to improve the quality of the LINE Developers site and developer documentation to make it even easier for developers to develop services using the LINE Platform.

Roadmap for LINE Login and LIFF have been updated
2024/12/17

We've updated a roadmap of upcoming features and the release dates for the LINE Login, LINE Front-end Framework (LIFF), and the LINE MINI App.

In the future, we plan to provide a means for submitting requests to the development team for features listed in the roadmap and for the products. Details will be announced as they are finalized.

The source code for the LIFF CLI is now available on GitHub
2024/12/16

LY Corporation provides a CLI tool called LIFF CLI to help developers develop LIFF apps more smoothly. The source code for the LIFF CLI is now available on GitHub.

For more information, see LIFF CLI in the LIFF documentation.

LIFF v2.25.1 released
2024/12/13

We've released LIFF v2.25.1.

In LIFF v2.25.1, we've made changes to the internal behavior of the LIFF SDK. There is no change in features.

# How to update to LIFF v2.25.1

If you're using the CDN edge path (https://static.line-scdn.net/liff/edge/2/sdk.js), you'll automatically update LIFF to v2.25.1.

If you're using an npm package, you can update to v2.25.1 by executing either npm install @line/liff@2.25.1 or yarn add @line/liff@2.25.1.

For more information on integrating the LIFF SDK, see Integrating the LIFF SDK with the LIFF app in the LIFF documentation.

LINE Official Account payment method re-registration required by March 31, 2025
2024/12/06

This is an announcement for those who have a LINE Official Account in Japan and have registered LINE Pay as a payment method, or who have registered a credit card as a payment method before February 14, 2023 in the LINE Official Account Manager (opens new window).

Due to the transfer of our system, you must re-register your payment method for your LINE Official Account by March 31, 2025. If you don't re-register, you won't be able to complete payment procedures after April 1, 2025, so we apologize for the inconvenience, but please take care of this before the deadline.

For more information, see [Important] Request to re-register payment method for LINE Official Account (opens new window) (only available in Japanese) in LINE for Business.

LINE MINI Apps now display a tooltip for adding shortcuts to the home screen
2024/12/05

Verified MINI Apps on LINE MINI Apps now display a tooltip for adding a shortcut to your LINE MINI App to the home screen.

This allows users to add a shortcut directly without having to tap the action button. The tooltip can also prompt your users to add a shortcut.

The tooltip has a notice that says, “You can add this MINI App to your home screen.” and a button to add a shortcut to the home screen and a button to close the tooltip.

For more information about shortcuts to your LINE MINI App, see Add a shortcut to your LINE MINI App to the home screen of the user's device in the LINE MINI App documentation.

# Target version

LINE version 14.20.0 or later for iOS or Android.

# Specifications

# Conditions for displaying the tooltip

The tooltip will be displayed when all of the following conditions are met:

  • Your LINE MINI App is a verified MINI App.
  • A user accesses your LINE MINI App for the first time.
  • A user's LINE app must be the target version.

# Conditions for hiding the tooltip

The tooltip will be hidden in one of the following cases:

  • When 24 hours have passed since the user first accessed your LINE MINI App.
  • When the user closes the tooltip with the close button.
  • When the user adds a shortcut to your LINE MINI App to the home screen.

Note that the tooltip will not be hidden even if the user operates the LINE MINI App by tapping somewhere other than the tooltip.

New LINE emojis are available with Messaging API
2024/12/02

With the LINE emoji update (opens new window) in the LINE app, we've increased the number of LINE emoji available with Messaging API. You can continue to use the existing LINE emoji as well. For more information, see LINE emoji in the Messaging API documentation.

You can send a LINE emoji to a user by specifying the product ID and emoji ID of the LINE emoji you want to use in the productId and emojiId properties of the Text message (v2) or Text message. For more information about sending messages, see Sending messages in the Messaging API documentation.

[Updated] As of November 28, 2024, anyone can now publish LINE MINI Apps
2024/11/27
Added on December 17, 2024

There was an issue where the correct design wasn't applied to the header of verified MINI Apps, but this issue has been fixed in LINE version 14.21.0.

Added on November 28, 2024

The release of this specification change has been completed. However, we're still working on the design issue indicated in What are verified MINI Apps and the delay in reflecting for some LINE MINI Apps indicated in Date of change.

Previously, all LINE MINI Apps had to pass our review process. As of November 28, 2024, anyone who can create a LINE MINI App channel can now publish a LINE MINI App as an unverified MINI App without a review.

Our review process will continue to be carried out, and LINE MINI Apps that pass the review process will become verified MINI Apps. Check the following sections for the differences between unverified and verified MINI Apps:

Creation of LINE MINI App channel (Added on December 5, 2024)

If your service area is Taiwan or Thailand, you can only create a LINE MINI App channel if you are approved by our local subsidiary. For more information, see Overall Process in the LINE MINI App documentation.

# What are unverified MINI Apps

Unverified MINI Apps are LINE MINI Apps that haven't yet passed our verification review. After you've created a LINE MINI App channel, the LINE MINI App will be an unverified MINI App until it passes the verification review.

Anyone can create an unverified MINI App, but as shown in the following section "What are verified MINI Apps", some features are restricted. To make your LINE MINI App a verified MINI App, submit your LINE MINI App for review.

# What are verified MINI Apps

If your LINE MINI App passes our verification review, it'll become a verified MINI App. Once it becomes a verified MINI App, it'll have a verified badge in the header, etc., as shown in the image below:

About an issue where the correct design isn't applied (Added on November 28, 2024)

Currently, there's an issue occurring in the header of verified MINI Apps where the correct design isn't applied. This issue is scheduled to be fixed in LINE version 14.21.0, which will be distributed at a later date.

In addition, you'll be able to use such as the following features:

As described above, by making your LINE MINI App a verified MINI App, you can enhance the user experience in terms of reliability and convenience. For more information about the features that can be used for verified MINI Apps, see Custom Features in the LINE MINI App documentation.

# Date of change

November 27, 2024 - November 28, 2024

This change will be made between November 27 and 28, 2024, and some features may not work properly until the change is complete. We'll notify you again in this news when the change is complete.

Delay in reflecting for some LINE MINI Apps

It's taking some time for some of the already published LINE MINI Apps to be reflected as verified MINI Apps. We apologize for any inconvenience.

# Notes on other changes

In line with these changes, the documentation provided on the LINE Developers site has also been updated. In addition, the user interface of the tabs and other parts of the LINE MINI App channel in the LINE Developers Console will also be changed. The tab names will be changed as follows:

Before change After change
LIFF Web app settings
Workflow Review request

Until the completion of the changes scheduled for November 28, 2024, there will be differences between the documentation and some of the content in the LINE Developers Console. Thank you for your understanding.

LINE MINI App Policy has been revised on November 27, 2024
2024/11/27

As announced on November 20, 2024, we've revised the LINE MINI App Policy (opens new window) on November 27, 2024.

# Date of revision

November 27, 2024

# Details of revision

  • Change the content to accommodate the unverified MINI App introduced on November 27, 2024
  • Add a requirement that you use the advertising distribution platform designated by our company for advertising distribution within the LINE MINI App

# Background of revision

Until now, in order for a service provider to publish a LINE MINI App, the service provider had to pass review by LY Corporation. However, in order to make the LINE MINI App more widely available to service providers, we've introduced a new type of the LINE MINI App (Unverified MINI App) that can be published without review by LY Corporation, in addition to the existing LINE MINI App (Verified MINI App). In line with this, we've revised the LINE MINI App Policy to accommodate all LINE MINI Apps, including unverified MINI Apps.

In addition, in order to ensure the integrity of advertising distribution, we've revised the LINE MINI App Policy to require the use of the advertising distribution platform designated by our company.

# Contact

For contact information regarding the advertising distribution platform, see Is there a designated advertising distribution platform within the LINE MINI App? (opens new window) (only available in Japanese) in LINE for Business.

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

[Updated] Due to the redesign of the LINE MINI App header, the "Header background color" feature has been discontinued
2024/11/27
Added on December 17, 2024

There was an issue where the correct design wasn't applied to the header of verified MINI Apps, but this issue has been fixed in LINE version 14.21.0.

Added on November 28, 2024

Currently, there's an issue occurring in the header of verified MINI Apps where the correct design isn't applied. This issue is scheduled to be fixed in LINE version 14.21.0, which will be distributed at a later date.

As announced on October 10, 2024, due to the redesign of the LINE MINI App header, the "Header background color" feature has been discontinued.

# Date of header redesign

November 27, 2024

# Changes

The header of the LINE MINI App has been changed as follows:

  • In LINE MINI App channels of the LINE Developers Console, the "Header background color" section has been removed from the LIFF tab and the "Header background color" feature is no longer available.
  • The header background color of existing LINE MINI Apps has been unified to white.
  • The header design of the LINE MINI App has been redesigned.
Before changes After changes (current)

# Background

Until now, in order for a service provider to publish a LINE MINI App, the service provider had to pass review by LY Corporation. However, in order to make the LINE MINI App more widely available to service providers, we've introduced a new type of the LINE MINI App (Unverified MINI App) that can be published without review by LY Corporation, in addition to the existing LINE MINI App (Verified MINI App).

In line with this, we've redesigned the header and are now providing unified headers for all verified MINI Apps so that end users can tell whether a LINE MINI App is verified or not.

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

The LINE Official Account API Terms of Use were revised on November 26, 2024
2024/11/26

As announced on November 11, 2024, we revised the "LINE Official Account API Terms of Use" for some countries and regions on November 26, 2024.

# Date of change

November 26, 2024

# Changes

The "LINE Official Account API Terms of Use" were revised as follows:

  • Article 7 was changed
  • Article 9 before the revision was deleted

See the revised "LINE Official Account API Terms of Use" at the following links:

dummy dummy
Thailand (TH) ข้อกำหนดการใช้งานบัญชีทางการด้วยระบบเอพีไอ (LINE Official Account API Terms of Use) (opens new window)
Taiwan (TW) LINE Official Account API Terms of Use (opens new window)
Other LINE Official Account API Terms of Use (opens new window)

We've not revised the LINE Official Account API Terms of Use (opens new window) for Japan (JP).

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

LINE MINI App Policy will be revised on November 27, 2024
2024/11/20

LINE MINI App Policy (opens new window) will be revised on November 27, 2024.

# Scheduled date of revision

November 27, 2024

The content and date are subject to change.

# Details of revision

  • Change the content to accommodate the unverified MINI App scheduled to be introduced in late November 2024
  • Add a requirement that you use the advertising distribution platform designated by our company for advertising distribution within the LINE MINI App

The differences between before and after the revision are as follows:

Before the revision (current) After the revision
LINE MINI App Policy (opens new window) LINE MINI App Policy (opens new window)

# Background of revision

Until now, in order for a service provider to publish a LINE MINI App, the service provider had to pass review by LY Corporation. However, in order to make the LINE MINI App more widely available to service providers, we plan to introduce a new type of the LINE MINI App (Unverified MINI App) that can be published without review by LY Corporation, in addition to the existing LINE MINI App (Verified MINI App). In line with this, we've decided to revise the LINE MINI App Policy to accommodate all LINE MINI Apps, including unverified MINI Apps.

In addition, in order to ensure the integrity of advertising distribution, we've decided to revise the LINE MINI App Policy to require the use of the advertising distribution platform designated by our company.

# Contact

For contact information regarding the advertising distribution platform, see Is there a designated advertising distribution platform within the LINE MINI App? (opens new window) (only available in Japanese) in LINE for Business.

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

[Resolved] Notice about service outage for LINE Login and LIFF/LINE MINI App
2024/11/18

We'd like to inform you about a service outage regarding the LINE Login, LIFF, and the LINE MINI App. The issue has now been resolved. We sincerely apologize for any inconvenience that this may have caused.

# Date and time of outage

November 15, 2024 around 16:46 - around 17:16 (UTC+9)

# Cause of the outage

Server failure

# Impact

  • LINE Login
  • LIFF/LINE MINI App

# Details

These are the main impacts per product:

# LINE Login

There were instances where the LINE Login didn't work per usual.

# LIFF/LINE MINI App

There were instances where the channel consent screen in LIFF/LINE MINI App could not be displayed.


We'll continue to improve the quality of its services to prevent future outages. Thank you for your understanding.

[Resolved] Notice about service outage for the LINE Platform
2024/11/12

We'd like to inform you about a service outage regarding the LINE Platform. The issue has now been resolved. We sincerely apologize for any inconvenience that this may have caused.

# Date and time of outage

November 12, 2024 around 10:23 - around 10:26 (UTC+9)

# Cause of the outage

Server failure

# Impact

  • Messaging API
  • LINE Login
  • LIFF/LINE MINI App

# Details

These are the main impacts per product:

# Messaging API

Some requests to each endpoint weren't processed properly, resulting in errors such as status code 5xx.

Due to this outage, the messages that weren't properly sent even if the API requests succeeded, won't be counted as the LINE Official Account usage fees and the "number of sent messages" that can be confirmed in some way such as the Get number of sent push messages endpoint.

# LINE Login

  • There were instances where the LINE Login didn't work per usual.
  • Some requests to each endpoint weren't processed properly, resulting in errors such as status code 5xx.

# LIFF/LINE MINI App

  • There were instances where LIFF/LINE MINI App couldn't be used per usual.
  • Some requests to each endpoint weren't processed properly, resulting in errors such as status code 5xx.

We will continue to improve the quality of its services to prevent future outages. Thank you for your understanding.

LIFF v2.25.0 released
2024/11/12

We've released LIFF v2.25.0.

In LIFF v2.25.0, we've made the following change.

# We've changed the URLs generated by the liff.permanentLink.createUrlBy() method

As announced on November 11, 2024, we've made changes to the LIFF server side to ensure that URL processing complies with RFC 3986 (opens new window). As a result, the processing results for characters and codes in the queries of the URLs generated by the liff.permanentLink.createUrlBy() method have changed as follows:

Characters and codes Before change After change (current)
+ + %2B
* * %2A
%7E %7E ~
%20 + %20
; * Deleted %3B

* The result of processing ; is only applied when ; is at the end of the query.

For more information, see As of November 11, 2024, the results of URLs generated by some LIFF features changed in certain versions of the LINE app and LIFF SDK.

# How to update to LIFF v2.25.0

If you're using the CDN edge path (https://static.line-scdn.net/liff/edge/2/sdk.js), you'll automatically update LIFF to v2.25.0.

If you're using an npm package, you can update to v2.25.0 by executing either npm install @line/liff@2.25.0 or yarn add @line/liff@2.25.0.

For more information on integrating the LIFF SDK, see Integrating the LIFF SDK with the LIFF app in the LIFF documentation.

Notice of temporary suspension of LINE MINI App review due to addition of features
2024/11/12

In order to start providing unverified MINI Apps (*), we plan to make significant changes to the user interface in LINE MINI App channels of the LINE Developers Console. As a result, we will temporarily suspend review for LINE MINI Apps during the following period. We sincerely apologize for any inconvenience that this may cause and thank you for your understanding.

* LINE MINI Apps that can be published without review by LY Corporation

# Review suspension period

November 27, 2024 10:00 - November 28, 2024 18:00 (UTC+9)

The review suspension period is subject to change.

# Details

You won't be able to request a review of your LINE MINI App during the review suspension period. If you click the Request review button on the Workflow tab of your LINE MINI App channel during this period, you'll see an error message that says "An internal server error occurred. Please wait a while and try again.".

In addition, we'll suspend review of LINE MINI Apps during the review suspension period. Normally, it takes approximately 1-2 weeks for us to complete our review process, but since review will be suspended during this period, it may take longer than usual. Therefore, if you would like to have your application approved by the end of November, we recommend that you submit your application well in advance.

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

As of November 11, 2024, the results of URLs generated by some LIFF features changed in certain versions of the LINE app and LIFF SDK
2024/11/11

As announced in the October 15, 2024 news, we've made an update on the LIFF server side. As a result, the URLs generated by the share button in the action button displayed on the LIFF app header and the liff.permanentLink.createUrlBy() method have changed in certain versions in the LINE app and the LIFF SDK.

# Date of change

November 11, 2024

# Impact

The scope of the impact varies depending on the version of the LINE app and the LIFF SDK that the LIFF app is running on. The URL results differ depending on the version and features of the LIFF app, as shown below:

Target Version Feature
LINE app Earlier than 13.8.0, or 14.19.0 or later Share button in the header of the LIFF app
LIFF SDK 2.18.0 or later and earlier than 2.22.1, or 2.25.0 or later liff.permanentLink.createUrlBy()

In versions other than the above, the behavior remains the same before the update.

# Changes

On the LIFF server side, we've made changes to ensure that URL processing complies with RFC 3986 (opens new window). As a result, the processing results for characters and codes have changed in the query for the permanent link that can be obtained by executing the share button of the LIFF app or the liff.permanentLink.createUrlBy() method as follows:

Characters and codes Before change After change (current)
+ + %2B
* * %2A
%7E %7E ~
%20 + %20
; * Deleted %3B

* The result of processing ; is only applied when ; is at the end of the query.

# Examples

For example, if the endpoint URL of the LIFF app is https://example.com, and you pass https://example.com/?key=a%20b as an argument to the liff.permanentLink.createUrlBy() method, the permanent link that can be obtained changed as follows before and after the change:

Before change After change (current)
https://liff.line.me/{liffId}/?key=a+b https://liff.line.me/{liffId}/?key=a%20b

In this example, if the LIFF app in use is processing + as %20, it won't be affected by the change in the processing result for %20 due to this change.

# Important points about specification changes

As indicated in Impact, depending on the version of the LINE app on the user's device, the change may or may not affect the app. Implement the LIFF app so that it can be processed without any problems in either case.

# Contact

If you experience any problems with the LIFF app after the change, contact us using the inquiry form (opens new window) (Only available in Japanese). In the field "1) Tell us about your problem" in the form, select "Inquiry about a problem".

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

[Updated] On November 26, 2024, we will revise the LINE Official Account API Terms of Use
2024/11/11
Updated on November 26, 2024

We've updated the Changes.

We plan to revise the "LINE Official Account API Terms of Use" for some countries and regions on November 26, 2024.

# Scheduled date of change

November 26, 2024

The details and date are subject to change without notice.

# Changes

The "LINE Official Account API Terms of Use" are scheduled to be revised as follows:

  • Article 7 will be changed
  • Article 9 before the revision will be deleted

See the revised "LINE Official Account API Terms of Use" at the following links:

dummy dummy
Thailand (TH) ข้อกำหนดการใช้งานบัญชีทางการด้วยระบบเอพีไอ (LINE Official Account API Terms of Use) (opens new window)
Taiwan (TW) LINE Official Account API Terms of Use (opens new window)
Other LINE Official Account API Terms of Use (opens new window)

We won't revise the LINE Official Account API Terms of Use (opens new window) for Japan (JP).

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

The Messaging API now allows you to recognize mentions from a user to your bot
2024/10/30

As announced in the September 30, 2024 news, we've been provided a feature that allows users to mention a bot in group chats on the LINE app. In the Messaging API, we'd like to inform you that a property has been added to the webhook event object sent to the bot server when a user sends a message containing a mention.

This allows bots to recognize when they're mentioned by a user in group chats. If you already have implemented your own process for recognizing mentions to the bot, or if you want to implement a process on your bot server that responds to mentions by users, consider using the new specification for detection.

# Target version

LINE version 14.17.0 or later for iOS or Android.

# Added specifications

The following two specifications has been added with this release:

# 1. Addition of mention.mentionees[].isSelf

When a user sends a message that includes a mention, the mention property has been included in the text message object in the webhook event sent to the bot server. With this new specification, when a mention is made of a user or bot, the isSelf property is added to mentionees[] in the mention property.

mention.mentionees[].isSelf

Boolean

Not always included

Whether the mention is to the bot (destination) that received the webhook event. This is only included when the value of the mention.mentionees[].type property is user.

  • true: This is a mention to the bot that received the webhook event.
  • false: This is a mention to another user.

# 2. Setting values in the webhook event object when there is a mention to a bot

If a message sent by a user mentions your bot, the following values will be set in the text message object in the webhook event sent to the bot server:

  • mention.mentionees[].type will be set to user.
  • mention.mentionees[].userId will be set to the user ID of the bot.
  • mention.mentionees[].isSelf is set to true.

You can check the user ID of the bot in the destination property in the request body of the webhook and in the userId property which can be obtained using the Get bot info endpoint.

# Examples

The following are examples of the behavior when a user sends a message containing a mention, before and after the addition of the specification:

# Before the specification was added

Users have been able to mention other users in the chat room for some time now. When a user sends a message that includes a mention, a webhook event object containing the following message event was sent to the bot server:

"message": {
  "id": "444573844083572737",
  "type": "text",
  "quoteToken": "q3Plxr4AgKd...",
  "text": "@example Good Morning!!",
  "mention": {
    "mentionees": [
      {
        "index": 0,
        "length": 8,
        "userId": "U49585cd0d5...",
        "type": "user"
      }
    ]
  }
}

# After the specification was added (current)

After the specification was added, if there is a mention of a bot in the message sent by a user, a webhook event object containing the following message event will be sent to the bot server. At this time, the isSelf property will be set to true.

"message": {
  "id": "444573844083572737",
  "type": "text",
  "quoteToken": "q3Plxr4AgKd...",
  "text": "@example_bot Good Morning!!",
  "mention": {
    "mentionees": [
      {
        "index": 0,
        "length": 12,
        "userId": "{user ID of the bot}",
        "type": "user",
        "isSelf": true
      }
    ]
  }
}

If a message sent by a user mentions another user, the isSelf property is set to false as follows:

"message": {
  "id": "444573844083572737",
  "type": "text",
  "quoteToken": "q3Plxr4AgKd...",
  "text": "@example Good Morning!!",
  "mention": {
    "mentionees": [
      {
        "index": 0,
        "length": 8,
        "userId": "U49585cd0d5...",
        "type": "user",
        "isSelf": false
      }
    ]
  }
}

The structure of the webhook event object may change, as in the case of this specification addition. Implement your bot server so that it doesn't malfunction when receiving objects with a different structure than before. For more information, see Recommendation for implementation assuming non-breaking feature additions section in the Messaging API documentation.

# LINE Messaging API SDK Updates

For more information about the update status of each SDK release related to the above, see the LINE Messaging API SDK release notes.

In the Messaging API, we've released text message (v2) which allows you to mention users, etc
2024/10/30

In the Messaging API, we've released text message (v2) as a new message object. By using text message (v2), you can specify mentions to users. In addition, compared to the text message that we've provided up until now, it's now easier to specify LINE emoji.

# Date of specification addition

October 30, 2024

# Details

There is a text message as a message object when sending text to users. Unlike the existing text message, the newly added text message (v2) can substitute strings enclosed in { and } with mentions and emojis.

For example, you can specify the content of mentions or emojis in the substitution property as follows, and substitute strings enclosed in { and } in the value of the text property with mentions or emojis:

{
  "type": "textV2",
  "text": "Welcome, {user1}! {laugh}\n{everyone} There is a newcomer!",
  "substitution": {
    "user1": {
      "type": "mention",
      "mentionee": {
        "type": "user",
        "userId": "U49585cd0d5..."
      }
    },
    "laugh": {
      "type": "emoji",
      "productId": "5a8555cfe6256cc92ea23c2a",
      "emojiId": "002"
    },
    "everyone": {
      "type": "mention",
      "mentionee": {
        "type": "all"
      }
    }
  }
}

As with text message, the contents of text message (v2) can be verified using the Validate message objects of a reply message or Validate message objects of a push message endpoints.

You can continue to use text message

You can continue to use the text message that we've been providing up until now. However, we may only add new features to text messages (v2) from now on.

# Important points about mentions

Note the following when specifying mentions in text messages (v2):

  • Mention objects can only be used in reply message or push message.
  • The destination of the message must be a group chat or multi-person chat.
  • Your LINE Official Account that sends messages must be a member of the group chat or multi-person chat to which the message is being sent.
  • All mentioned users must be members of the group chat or multi-person chat to which the message is being sent.

For more information about text messages (v2), see Text message (v2) in the Messaging API reference.

# LINE Messaging API SDK Updates

For more information about the update status of each SDK release related to the above, see the LINE Messaging API SDK release notes.

[Resolved/Updated] Notice about service outage of the Messaging API
2024/10/18
Updated on October 28, 2024

We've updated the Date and Details.

We'd like to inform you about a service outage regarding the Messaging API. The issue has now been resolved. We sincerely apologize for any inconvenience that this may have caused.

# Date

October 4, 2024 - October 25, 2024

# Cause of the outage

Server failure

# Impact

# Details

For the endpoints related to retrieving the number of messages shown in the above impact, an issue was occurred in which the number of messages from October 4, 2024 to October 15, 2024 is doubled for some messages sent from some accounts. The data has been fixed and the correct number of messages can now be retrieved.

For accounts affected by this issue, the number of messages sent was also affected, so the maximum number of messages that could be sent may be reached and messages couldn't be sent. In this case, the 429 Too Many Requests error occured when sending a message.

This issue won't cause in excessive charges for LINE Official Accounts.

We'll continue to improve the quality of its services to prevent future outages. Thank you for your understanding.

As of November 11, 2024, the results of URLs generated by some LIFF features will change in certain versions of the LINE app and LIFF SDK
2024/10/15

On November 11, 2024, we're planning to make an update on the LIFF server side. As a result, the URLs generated by the share button in the action button displayed on the LIFF app header and the liff.permanentLink.createUrlBy() method will change in certain versions in the LINE app and the LIFF SDK.

# Scheduled date of change

November 11, 2024

The content and date of this specification change are subject to change.

# Impact

The scope of the impact will vary depending on the version of the LINE app and the LIFF SDK that the LIFF app is running on. The URL results will differ depending on the version and features of the LIFF app, as shown below:

Target Version Feature
LINE app Earlier than 13.8.0, or 14.19.0 or later Share button in the header of the LIFF app
LIFF SDK 2.18.0 or later and earlier than 2.22.1, or 2.25.0 or later liff.permanentLink.createUrlBy()

In versions other than the above, the behavior will remain the same after the update.

# Changes

On the LIFF server side, changes will be made to ensure that URL processing complies with RFC 3986 (opens new window). As a result, the processing results for characters and codes will change in the query for the permanent link that can be obtained by executing the share button of the LIFF app or the liff.permanentLink.createUrlBy() method as follows:

Characters and codes Before change (current) After change
+ + %2B
* * %2A
%7E %7E ~
%20 + %20
; * Deleted %3B

* The result of processing ; is only applied when ; is at the end of the query.

# Examples

Added on November 11, 2024

In the following example, the query for the argument passed to the liff.permanentLink.createUrlBy() method was key=a+b, but it should be key=a%20b. We apologize for the error and have corrected it.

For example, if the endpoint URL of the LIFF app is https://example.com, and you pass https://example.com/?key=a%20b as an argument to the liff.permanentLink.createUrlBy() method, the permanent link that can be obtained will change as follows before and after the change:

Before change (current) After change
https://liff.line.me/{liffId}/?key=a+b https://liff.line.me/{liffId}/?key=a%20b

In this example, if the LIFF app in use is processing + as %20, it won't be affected by the change in the processing result for %20 due to this change.

# Note

As indicated in Impact, depending on the version of the LINE app on the user's device, the change may or may not affect the app. Implement the LIFF app so that it can be processed without any problems in either case.

# Contact

If you experience any problems with the LIFF app after the change, contact us using the inquiry form (opens new window) (Only available in Japanese). In the field "1) Tell us about your problem" in the form, select "Inquiry about a problem".

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

[Updated] Due to the redesign of the LINE MINI App header scheduled for late November 2024, the "Header background color" feature will be discontinued
2024/10/10
Added on October 31, 2024

The scheduled date of header redesign was announced as mid-November, 2024, but has been changed to late November 2024. The changes have also been updated.

The LINE MINI App header is scheduled to be redesigned in late November 2024. As a result, the "Header background color" feature will be discontinued.

# Scheduled date of header redesign

Late November 2024

The content and date of the header redesign are subject to change.

# Changes

The header of the LINE MINI App will be changed as follows:

  • In LINE MINI App channels of the LINE Developers Console, the "Header background color" section will be removed from the LIFF tab, and the "Header background color" feature will no longer be available.
  • The header background color of existing LINE MINI Apps will be white.
  • The header design of the LINE MINI App will be redesigned.
Before changes After changes

# Background

Until now, in order for a service provider to publish a LINE MINI App, the service provider had to pass review by LY Corporation. However, in order to make the LINE MINI App more widely available to service providers, we plan to introduce a new type of the LINE MINI App (Unverified MINI App) that can be published without review by LY Corporation, in addition to the existing LINE MINI App (Verified MINI App).

In line with this, we've decided to redesign the header and provide unified headers for all verified MINI Apps so that end users can tell whether a LINE MINI App is verified or not.

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

LINE Notify service will be discontinued on March 31, 2025
2024/10/07

LINE Notify (opens new window) service will be discontinued on March 31, 2025.

# Scheduled date of service discontinuation

March 31, 2025

# Impact

After April 1, 2025, all LINE Notify features, including the following, will no longer be available:

  • All APIs of LINE Notify
    • notify-bot.line.me/*
    • notify-api.line.me/*
  • LINE Notify's My page (opens new window)
    • Add a service
    • Check connected services
    • Generate access tokens

In addition, The LINE Official Account "LINE Notify" (@linenotify) and the following web pages will be deleted after May 12, 2025:

# Alternative method

Please consider using the Messaging API as an alternative method of notifying users from your LINE Official Account. You can send a certain number of messages each month for free. For more information, see Messaging API pricing.

For more information about features available with the Messaging API, see the Messaging API documentation.

# Contact

Please contact us via the inquiry form (opens new window).

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

As of late October 2024, in the Messaging API, it will be possible to recognize mentions from a user to a bot
2024/09/30

As of late October 2024, we plan to provide a feature that allows users to mention a bot in group chats on the LINE app. Along with this, we'd like to inform you that a property will be added to the webhook event object sent to the bot server when a user sends a message containing a mention in the Messaging API.

This will allow bots to recognize when they're mentioned by a user in group chats. If you already have implemented your own process for recognizing mentions to the bot, or if you want to implement a process on your bot server that responds to mentions by users, consider using the new specification for detection.

# Scheduled date of adding specifications

Late October 2024

The details and date of this specification addition are subject to change without notice.

# Specifications to be added

The following two specifications will be added with this release:

# 1. Addition of mention.mentionees[].isSelf

When a user sends a message that includes a mention, the mention property has been included in the text message object in the webhook event sent to the bot server. With this new specification, when a mention is made of a user or bot, the isSelf property is added to mentionees[] in the mention property.

mention.mentionees[].isSelf

Boolean

Not always included

Whether the mention is to the bot (destination) that received the webhook event. This is only included when the value of the type property is user.

  • true: This is a mention to the bot (destination) that received the webhook event.
  • false: This is a mention to another user.

# 2. Setting values in the webhook event object when there is a mention to a bot

If a message sent by a user mentions the bot, the following values will be set in the text message object in the webhook event sent to the bot server:

  • mention.mentionees[].type will be set to user
  • mention.mentionees[].userId will be set to the user ID of the bot
  • mention.mentionees[].isSelf is set to true

You can check the user ID of the bot in the destination property in the request body of the webhook and in the userId property which can be obtained using the Get bot info endpoint.

# Examples

The following are examples of the behavior when a user sends a message containing a mention, before and after the addition of the specification:

# Before the specification was added (current)

Users have been able to mention other users in the chat room for some time now. When a user sends a message that includes a mention, a webhook event object containing the following message event is sent to the bot server:

"message": {
  "id": "444573844083572737",
  "type": "text",
  "quoteToken": "q3Plxr4AgKd...",
  "text": "@example Good Morning!! ",
  "mention": {
    "mentionees": [
      {
        "index": 0,
        "length": 8,
        "userId": "U49585cd0d5...",
        "type": "user"
      }
    ]
  }
}

# After the specification was added

After the specification is added, if there is a mention of a bot in the message sent by a user, a webhook event object containing the following message event will be sent to the bot server. In this way, the isSelf property will be set to true.

"message": {
  "id": "444573844083572737",
  "type": "text",
  "quoteToken": "q3Plxr4AgKd...",
  "text": "@example_bot Good Morning!!",
  "mention": {
    "mentionees": [
      {
        "index": 0,
        "length": 12,
        "userId": "{user ID of the bot}",
        "type": "user",
        "isSelf": true
      }
    ]
  }
}

If a message sent by a user mentions another user, the isSelf property is set to false as follows:

"message": {
  "id": "444573844083572737",
  "type": "text",
  "quoteToken": "q3Plxr4AgKd...",
  "text": "@example Good Morning!!",
  "mention": {
    "mentionees": [
      {
        "index": 0,
        "length": 8,
        "userId": "U49585cd0d5...",
        "type": "user",
        "isSelf": false
      }
    ]
  }
}

The structure of the webhook event object may change, as in the case of this specification addition. Implement your bot server so that it doesn't malfunction when receiving objects with a different structure than before. For more information, see Recommendation for implementation assuming non-breaking feature additions section in the Messaging API documentation.

In-store POP templates for LINE MINI Apps are now available
2024/09/27

We've released POP templates (Japanese, English, Chinese) that allow you to easily create POP with QR codes for LINE MINI Apps. You can use them for scenes such as issuing waiting list numbered tickets in stores, mobile ordering in stores, presenting membership and loyalty cards, etc.

QR Code for mobile order demo app

You can download the POP templates from In-store POP templates for LINE MINI Apps are now available! (opens new window) (only available in Japanese) in LINE Creative Inspiration.

When using the template with a QR code, create a permanent link to the LINE MINI App. For more information, see Sharing the LINE MINI App Link in the LINE MINI App documentation.

[Resolved] Notice about service outage for the LINE Platform
2024/09/26

We'd like to inform you about a service outage regarding the LINE Platform. The issue has now been resolved. We sincerely apologize for any inconvenience that this may have caused.

# Date and time of outage

September 26, 2024 around 12:49 - around 13:07 (UTC+9)

# Cause of the outage

Server failure

# Impact

  • Messaging API
  • LINE Login
  • LIFF/LINE MINI App

# Details

These are the main impacts per product:

# Messaging API

Some requests to each endpoint weren't processed properly, resulting in errors such as status code 5xx.

Due to this outage, the messages that weren't properly sent even if the API requests succeeded, won't be counted as the LINE Official Account usage fees and the "number of sent messages" that can be confirmed in some way such as the Get number of sent push messages endpoint.

# LINE Login

  • There were instances where the LINE Login didn't work per usual.
  • Some requests to each endpoint weren't processed properly, resulting in errors such as status code 5xx.

# LIFF/LINE MINI App

  • There were instances where LIFF/LINE MINI App couldn't be used per usual.
  • Some requests to each endpoint weren't processed properly, resulting in errors such as status code 5xx.

When an outage occurs, we post a preliminary report on the LINE API Status. For more information, see the news from April 5, 2021, LINE API Status site for checking service availability opened.

We will continue to improve the quality of its services to prevent future outages. Thank you for your understanding.

LIFF CLI v0.2.0 released
2024/09/24

We've released LIFF CLI v0.2.0.

In LIFF CLI v0.2.0, we've added the serve command. The serve command allows you to launch a local development server with HTTPS or to debug your LIFF app with the LIFF Inspector. This allows you to develop your LIFF app more smoothly.

# Launch a local development server with HTTPS

The serve command allows you to launch a local developement server with HTTPS.

Specifying your local development server, where your LIFF app is running, in the serve command launches a local proxy server with HTTPS and rewrites the endpoint URL of your LIFF app with the URL of the local proxy server. This makes it easier for you to launch your local development server with HTTPS.

Don't execute the serve command for a published LIFF app

The serve command rewrites the endpoint URL of the LIFF app with the URL of the local proxy server, so users can't access the LIFF app. Therefore, don't execute the serve command for a published LIFF app.

# If you specify your local development server with the URL
$ liff-cli serve \
   --liff-id 1234567890-AbcdEfgh \
   --url http://localhost:3000/

Successfully updated endpoint url for LIFF ID: 1234567890-AbcdEfgh.

→  LIFF URL:     https://liff.line.me/1234567890-AbcdEfgh
→  Proxy server: https://localhost:9000/
# If you specify your local development server with the host and port number
$ liff-cli serve \
   --liff-id 1234567890-AbcdEfgh \
   --host localhost \
   --port 3000

Successfully updated endpoint url for LIFF ID: 1234567890-AbcdEfgh.

→  LIFF URL:     https://liff.line.me/1234567890-AbcdEfgh
→  Proxy server: https://localhost:9000/

For more information about how to launch a local development server with HTTPS, see Launch a local development server with HTTPS in the LIFF documentation.

# Debug your LIFF app with the LIFF Inspector

You can debug your LIFF app with the LIFF Inspector by specifying the --inspect option to the serve command.

The --inspect option launches the LIFF Inspector's LIFF Inspector Server with HTTPS. This allows developers to debug their LIFF apps by simply installing the LIFF Inspector Plugin in their LIFF apps. For more information, see README (opens new window) of the LIFF Inspector.

$ liff-cli serve \
   --liff-id 1234567890-AbcdEfgh \
   --url http://localhost:3000/ \
   --inspect

Successfully updated endpoint url for LIFF ID: 1234567890-AbcdEfgh.

→  LIFF URL:     https://liff.line.me/1234567890-AbcdEfgh
→  Proxy server: https://localhost:9000/?li.origin=wss%3A%2F%2Flocalhost%3A9222
Debugger listening on wss://192.168.1.6:9222

You need to serve this server over SSL/TLS
For help, see: https://github.com/line/liff-inspector#important-liff-inspector-server-need-to-be-served-over-ssltls

When you access the LIFF URL, a URL starting with devtools://devtools/ appears in the terminal where the serve command was executed. If you open this URL with Google Chrome, you can debug the LIFF app on Google Chrome.

connection from client, id: 1234567890-AbcdEfgh
DevTools URL: devtools://devtools/bundled/inspector.html?wss=localhost:9222/?hi_id=1234567890-AbcdEfgh

For more information about the LIFF CLI, see LIFF CLI in the LIFF documentation.

Roadmap for LINE Login and LIFF now available
2024/09/20

We've released a roadmap of upcoming features and the release dates for the LINE Login, as well as for the LINE Front-end Framework (LIFF) and the LINE MINI App, which use the system provided by the LINE Login.

In the future, we plan to provide a means for submitting requests to the development team for features listed in the roadmap and for the products. Details will be announced as they are finalized.

On LINE for iOS version 14.15.1 or later, you can now minimize LINE MINI Apps from the header
2024/09/17

On LINE for iOS version 14.15.1 or later, you can now minimize LINE MINI Apps from the header.

The close button was located in the header of the LINE MINI App, but on iOS it's been changed to a minimize button.

Previously, tapping the close button in the header would close the LINE MINI App, so you'd have to reopen the LINE MINI App the next time you used it.

On LINE for iOS version 14.15.1 or later, the button in the header is a minimize button, and when you tap it, the LINE MINI App will be minimized. By tapping the minimized LINE MINI App, you can access it again, making it easier for users to access the same LINE MINI App.

The close button will continue to be displayed in Android and in some LINE MINI App that don't support the minimize function.

# Release date

September 17, 2024

# Target version

LINE for iOS version 14.15.1 or later

# Conditions for minimizing the LINE MINI App

The conditions for minimizing the LINE MINI App are based on the Conditions of use for LIFF browser minimization.

If the LINE MINI App doesn't meet the conditions of use for LIFF browser minimization, the close button will be displayed instead of the minimize button.

# How to close LINE MINI Apps

To close the LINE MINI App, minimize the LINE MINI App and then perform one of the following actions:

  • Swipe the minimized LINE MINI App off the screen.
  • Drag the minimized LINE MINI App to the close icon.

For more information on how to minimize, see Minimizing LIFF browser in the LIFF documentation.

Messaging API now provides statistics on the percentage of friends between the ages of 50 and 70
2024/09/05

In the Messaging API, we've added the following values as the percentage of each age group of your LINE Official Account's friends that you can get by using the Get friend demographics endpoint:

  • from50to54
  • from55to59
  • from60to64
  • from65to69
  • from70

Previously, we've aggregated the percentage of friends who are 50 and older as a single value, from50. With this change, you can now get statistics on the percentage of friends between the ages of 50 and 70.

We'll continue to include from50 in the response as a value that aggregates the percentage of friends who are 50 and older.

# LINE Messaging API SDK Updates

For more information about the update status of each SDK release related to the above, see the LINE Messaging API SDK release notes.

As of September 4, 2024, it's no longer possible to create Messaging API channels directly from the LINE Developers Console
2024/09/04

As announced on August 14, 2024, As of September 4, 2024, it's no longer possible to create Messaging API channels directly from the LINE Developers Console.

From now on, you can create Messaging API channels by creating a LINE Official Account and then enabling the use of the Messaging API in the LINE Official Account Manager (opens new window).

# Specification change date

September 4, 2024

# How to create a Messaging API channel after the specification change

After the specification change, follow these steps to create a Messaging API channel:

  1. Create your LINE Official Account.

    For more information, see 1. Create a LINE Official Account in the Messaging API documentation.

  2. Enable the use of the Messaging API with your LINE Official Account.

    For more information, see 2. Enable the Messaging API for your LINE Official Account in the Messaging API documentation.

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

As of September 3, 2024, two-step verification has been enabled for login to the LINE Developers Console
2024/09/03

As announced on August 30, 2024, as of September 3, 2024, two-step verification has been enabled on the LINE Business ID in order to enhance security.

The login code for two-step verification is sent to the email address registered on your LINE Business ID. Therefore, if you can't receive the login code, you may not be able to login to the LINE Developers Console.

Users who haven't registered their email address with their LINE Business ID won't be affected by this change, as two-step verification won't be enabled.

For more information, see the following articles:

You can check and change your registered email address on the Settings page (opens new window) of your LINE Business ID. Make sure that you can receive the login code at your registered email address.

You can also turn off the enabled two-step verification on the LINE Business ID settings page

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

As of September 3, 2024, two-step verification will be enabled for login to the LINE Developers Console
2024/08/30

As of September 3, 2024, two-step verification will be enabled on the LINE Business ID for security reasons.

The login code for two-step verification will be sent to the email address registered on your LINE Business ID. Therefore, if you can't receive the login code, you may not be able to login to the LINE Developers Console.

Users who haven't registered their email address with their LINE Business ID won't be affected by this change, as two-step verification won't be enabled.

For more information, see Enabling Two-step verification for LINE Business ID (Scheduled for 2024/9/3) (opens new window) (only available in Japanese) in LINE for Business.

You can check and change your registered email address on the Settings page (opens new window) of your LINE Business ID. Before enabling two-step verification, make sure that you can receive the login code at your registered email address.

You can also turn off the enabled two-step verification on the LINE Business ID settings page

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

In the Messaging API, you can now use narrowcast messages to filter the detailed age range of 50 to 70
2024/08/26

In the Messaging API, we've added the following values as conditions for filtering the age range of recipients in the demographic filter objects of narrowcast messages:

  • age_55
  • age_60
  • age_65
  • age_70

Until now, the upper limit was age_50, so it wasn't possible to filter ages over 50 in detail. By specifying the added age ranges, you can now filter recipients more flexibly than before.

For example, the following is a demographic filter object that filters by age 50 and older but less than 60:

{
  "type": "age",
  "gte": "age_50",
  "lt": "age_60"
}

# LINE Messaging API SDK Updates

For more information about the update status of each SDK release related to the above, see the LINE Messaging API SDK release notes.

As of September 4, 2024, it will no longer be possible to create Messaging API channels directly from the LINE Developers Console
2024/08/14

As of September 4, 2024, it will no longer be possible to create Messaging API channels directly from the LINE Developers Console.

After this date, you can create Messaging API channels by creating a LINE Official Account in the LINE Official Account Manager (opens new window) and then enabling the use of the Messaging API.

# Scheduled date of change

September 4, 2024

The content and date of this specification change are subject to change.

# How to create a Messaging API channel after specification changes

After the specification change, follow these steps to create a Messaging API channel:

  1. Create your LINE Official Account

    For more information, see Creating new LINE Official Accounts (opens new window) in Help Center.

  2. Enable the use of the Messaging API with your LINE Official Account

    For more information, see Use the Messaging API with your existing LINE Official Account in the Messaging API documentation.

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

Maintenance notice for the LINE Platform
2024/08/13

Maintenance is scheduled on the LINE Platform. We sincerely apologize for any inconvenience that this may cause and thank you for your understanding.

# Date and time of maintenance

August 28, 2024 around 5:00 - around 6:00 (UTC+9)

Note that the date and time of maintenance are subject to change without notice.

# Impact

During the maintenance period, the system will be unavailable for several minutes multiple times, so the following operations may not be possible for each product. Note that operations other than those listed below can be operated even during maintenance.

# Channel access token

# Messaging API

  • Execution of the Messaging API endpoints (api.line.me/v2/bot/* and api-data.line.me/v2/bot/*)

  • Receive webhook events

    Webhook events may be delayed or lost.

# LINE Login / LIFF / LINE MINI App

  • All login attempts
  • Launch LIFF apps and LINE MINI Apps

# Options for corporate customers

# LINE Developers Console

  • Create a channel, change settings and edit roles
In the LINE Social Plugins, we've changed the destination when clicking the Share button on a computer from Keep to Keep Memo
2024/07/31

In the LINE Social Plugins, when you click the Share button on your computer, a pop-up will appear to select the destination.

Previously, you could choose either "Chat" or "Keep" as your destination, but since the Keep service will be discontinued on August 28, 2024, we've changed "Keep" to "Keep Memo".

For more information about the end of the Keep service, see About the end of the Keep service (opens new window) in the Help Center.

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

LIFF v2.24.0 released
2024/07/23

We've released LIFF v2.24.0.

In LIFF v2.24.0, we've added the following feature.

# We've added the liff.getAppLanguage() method which gets the language setting of the LINE app running the LIFF app

We've added the liff.getAppLanguage() method which gets the language setting of the LINE app running the LIFF app.

The LIFF SDK has a similar method, liff.getLanguage(). You can use the liff.getLanguage() method to get the language setting of the environment running the LIFF app, but in some iOS environments there is a bug where the language setting of the OS is reflected instead of the language setting of the LINE app.

Therefore, with the addition of the liff.getAppLanguage() method, the liff.getLanguage() method has been deprecated. Use the liff.getAppLanguage() method from now on.

For more information about the language setting of the LINE app, see Changing the LINE app language setting (opens new window) in the Help Center.

# How to update to LIFF v2.24.0

If you're using the CDN edge path (https://static.line-scdn.net/liff/edge/2/sdk.js), you'll automatically update LIFF to v2.24.0.

If you're using an npm package, you can update to v2.24.0 by executing either npm install @line/liff@2.24.0 or yarn add @line/liff@2.24.0.

For more information on integrating the LIFF SDK, see Integrating the LIFF SDK with the LIFF app in the LIFF documentation.

LIFF CLI, a CLI tool to help you develop LIFF apps more smoothly, released
2024/07/23

# What is the LIFF CLI

LIFF CLI is a CLI tool to help you develop LIFF apps more smoothly. The LIFF CLI allows you to create, update, list, and delete LIFF apps from the command line.

In addition, Create LIFF App, LIFF Inspector, and LIFF Mock functions will be added in future updates.

# Install the LIFF CLI

Open a terminal or command line tool (hereafter referred to as "terminal") and execute the following command:

$ npm install -g @line/liff-cli

The command will install the LIFF CLI and allow you to run the liff-cli command.

# Sample code

For example, to create a LIFF app with a LIFF app name of "Brown Coffee", an endpoint URL of "https://example.com", and a view size of "Full", execute the following command:

$ liff-cli app create \
  --name "Brown Coffee" \
  --endpoint-url https://example.com \
  --view-type full

For more information about the LIFF CLI, see LIFF CLI in the LIFF documentation.

Alert of unauthorized access to business accounts
2024/07/19

We have confirmed that there is currently an unauthorized access targeting "Business accounts", which appears to be caused by a password list attack.

A password list attack is an attack method in which an attacker attempts to log in to another service using a list of IDs and passwords obtained by some method. If you use the same ID and password for multiple services, an unauthorized login by a third party is possible.

If you receive an unfamiliar login notification (an email with the subject line LINE Business ID login notification), please change your password to prevent unauthorized access.

To keep your account secure, we recommend that you change your password if you use the same ID and password combination for other services, and that you use the two-step verification feature on your LINE Business ID. You can set up two-step verification on the Settings page (opens new window) of your LINE Business ID.

This unauthorized access has only been confirmed with the login with business account. We have not confirmed any impact on users who have not registered their email address in their LINE Business ID and only use the login with LINE account.

LINE SDK for Android v5.10.1 released
2024/07/02

We've released LINE SDK for Android v5.10.1. In this release, we've removed deprecated package dependencies due to the end of API support for androidx.lifecycle:lifecycle-extensions.

As a result of these changes, build errors caused by package dependencies have been fixed.

Release notes for LINE SDK for Android are available on the GitHub repository. For more information, see Release 5.10.1 (opens new window) in Releases (opens new window).

[Resolved] Notice about service outage for the LINE Platform
2024/06/27

We'd like to inform you about a service outage regarding the LINE Platform. The issue has now been resolved. We sincerely apologize for any inconvenience that this may have caused.

# Date and time of outage

June 25, 2024 around 16:30 - around 17:14 (UTC+9)

# Cause of the outage

Server failure

# Impact

  • Messaging API
  • LINE Login
  • LIFF/LINE MINI App

# Details

These are the main impacts per product:

# Messaging API

Some requests to each endpoint weren't processed properly, resulting in errors such as status code 5xx.

Due to this outage, the messages that weren't properly sent even if the API requests succeeded, won't be counted as the LINE Official Account usage fees and the "number of sent messages" that can be confirmed in some way such as the Get number of sent push messages endpoint.

# LINE Login

  • There were instances where LINE Login didn't work per usual.
  • Some requests to each endpoint weren't processed properly, resulting in errors such as status code 5xx.

# LIFF/LINE MINI App

  • There were instances where LIFF/LINE MINI App couldn't be used per usual.
  • Some requests to each endpoint weren't processed properly, resulting in errors such as status code 5xx.

When an outage occurs, we post a preliminary report on the LINE API Status. For more information, see the news from April 5, 2021, LINE API Status site for checking service availability opened.

We will continue to improve the quality of its services to prevent future outages. Thank you for your understanding.

We've published best practices for provider and channel management
2024/06/27

We've published Best practices for provider and channel management in the LINE Developers Console documentation.

This page provides best practices about how to manage providers and channels when developing services using the LINE Platform.

By following these best practices, you can avoid problems such as "Only the company to which we outsourced our operations had roles, so once the contract was terminated, we can no longer set up providers and channels" or "The person in charge resigned, so there is no one left with a role for the channel" and operate providers and channels more smoothly.

We'll continue to improve the quality of the LINE Developers site and developer documentation to make it even easier for developers to develop services using the LINE Platform.

We've published a document for implementing web apps in operation as LINE MINI Apps
2024/06/24

We've published the page Implementing web apps in operation as LINE MINI Apps in the LINE MINI App documentation.

If you want to implement your web app as a LINE MINI App, you may not know how to do it. The above page provides an overview of LINE MINI Apps, as well as the knowledge and procedures required to implement your web app as a LINE MINI App. By reading this page, you'll be able to get an overall picture of what it takes to implement a web app as a LINE MINI App.

We'll continue to improve the quality of the LINE Developers site and developer documentation to make it even easier for developers to develop LINE MINI Apps.

In the LINE MINI App, you can now set your own string to the LIFF URL
2024/05/29

In the LINE MINI App, the Custom Path feature has been released, which allows you to set your own string in the LIFF URL of the published channel as follows:

Example URL with LIFF ID Example of setting Custom Path
https://miniapp.line.me/123456-abcdefg https://miniapp.line.me/cony_coffee

For example, by setting a unique name as a Custom Path, users will be able to identify which brand or shop's LINE MINI App from the URL. For more information on how to configure, see Configuring Custom Path.

# Release date

May 29, 2024

# How to configure

To use the Custom Path feature, apply using the form below (only available in Japanese):

Application form (opens new window)

You will be notified of the confirmation of your application and the result of the review by email. Currently, this feature is only available when the region to provide the service is Japan.

# Note

Even if a Custom Path is set, the LIFF URL with the Custom Path set won't be displayed on the LINE Developers Console. In addition, currently an application via the application form is required, but with a future release it'll be possible to set up a Custom Path on the LINE Developers Console.

We've discontinued providing LINE Things documents and references
2024/05/13

We've discontinued providing LINE Things documents and references as of May 13, 2024.

We've already discontinued providing the LINE Things Developer Trial as of March 31, 2024. Accordingly, we've also discontinued providing the documents and references.

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

Maintenance notice for Messaging API, module, and LINE Developers Console
2024/05/07

Maintenance is scheduled on the Messaging API, the module, and the LINE Developers Console. We sincerely apologize for any inconvenience that this may cause and thank you for your understanding.

# Date and time of maintenance

June 5, 2024 around 2:00 - around 3:00 (UTC+9)

Note that the date and time of maintenance are subject to change without notice.

# Impact

During maintenance, the following operations for each product won't be available. Note that operations other than those listed below can be operated even during maintenance.

# Messaging API

# Module (Options for corporate customers)

# LINE Developers Console

In the LINE MINI App, users can now skip the pop-ups that ask for access to the camera and microphone
2024/04/24

On LINE version 14.6.0, in the LINE MINI App, users can now skip the pop-ups that ask for access to the camera and microphone.

In the LINE MINI App, when accessing the camera or microphone, a pop-up would appear asking the user to allow access. Each time the pop-up appeared, the user had to select "Allow only this time" to allow access, which was detrimental to the user experience in services where the camera and microphone are frequently used (e.g. mobile self-checkout).

On LINE versions 14.6.0 or later, users can now select "Always allow" in addition to "Allow only this time". After selecting "Always allow", users will skip the pop-ups that ask for access to the camera and microphone in that LINE MINI App. This allows you to provide a better user experience.

LINE versions earlier than 14.6.0 LINE versions 14.6.0 or later

Users can also set the camera and microphone permissions of a LINE MINI App from Permission setting in the action button.

We've improved the behavior of the liff.scanCodeV2() method
2024/04/18

We've made two improvements to the liff.scanCodeV2() method. These improvements are automatically applied to all LIFF apps, so there is no need to update the LIFF SDK or modify the code in your LIFF apps.

# We've improved the reading accuracy of 2D codes

We've improved the reading accuracy of 2D codes in the liff.scanCodeV2() method. Note that the reading accuracy depends on the camera performance of a device, so there may not be a noticeable improvement depending on the user's device.

# We've improved the header label of the 2D code reader

In the liff.scanCodeV2() method, we've changed the header label of the 2D code reader as follows to make it easier for users to understand that LY Corporation gets and analyzes 2D code information and provides the analysis results to the service provider.

Before change (Code reader) After change (Code reader © LY Corporation)
In the Messaging API, you can now display loading animations on the chat screen with users
2024/04/17

In the Messaging API, we've added a new endpoint that allows you to display a loading animation. After your LINE Official Account receives a message from a user, the response may takes some time due to message preparation or reservation processing. In such cases, you can visually tell the user that you want them to wait by displaying a loading animation.

The loading animation will automatically disappear after the specified number of seconds has elapsed or when a new message arrives from your LINE Official Account.

For more information, see Display a loading animation in the Messaging API documentation.

# Target version

LINE version 13.16.0 or later for iOS or Android.

# LINE Messaging API SDK Updates

For more information about the update status of each SDK release related to the above, see the LINE Messaging API SDK release notes.

In accordance with the LINE Login development guidelines, deauthorize your app when a user unregisters from your app
2024/04/08

In LINE Login, we've added an endpoint to deauthorize your app on behalf of the user, revoking the permissions the user has previously granted.

# Added endpoint

Accordingly, the required matter "Deauthorize your app when a user unregisters from your app" has been added to the LINE Login development guidelines.

When developing an app (website, smartphone app, etc.) that integrates LINE Login, read the LINE Login development guidelines carefully and follow the instructions. For more information about how a user can deauthorize your app to which the user has granted permissions, see Managing authorized apps in the LINE Login documentation.

Announcement of the LINE DC BOT AWARDS 2024
2024/04/01

The "LINE DC BOT AWARDS 2024 (opens new window)" (only available in Japanese) application development contest has been announced. This contest is led by LINE API Experts (opens new window) and aims to promote the development of LINE Bot, which will open up a new era.

The LINE DC BOT AWARDS 2024 will recognize particularly outstanding services based on the three axes of value, novelty, and technology. Entry requirements include services that use a LINE Official Account with the Messaging API enabled as the main UI.

# Official site

https://lineapiusecase.com/ja/community/linedc-award-2024.html (opens new window) (only available in Japanese)

# Schedules

  • Application deadline: May 7, 2024
  • Final judge: Within May 2024

# How to apply

Check the judging criteria and application requirements on the official site and apply online.

# About the prizes

The following prizes will be awarded to the outstanding entries:

  • Grand Prize: 1,000,000 yen
  • Excellence Award (2 entries): 500,000 yen each

For more information, see the official site (opens new window).

In the Messaging API, you can resume using the endpoints for retrieving membership information
2024/03/28

The endpoints for retrieving membership information, which we had suspended since February 14, 2024, are now available again.

Some specifications, such as endpoint URLs, have been changed. So please be careful if you've started using it before February 14.

How to start a membership

You can set up and publish your membership on the LINE Official Account Manager (opens new window). For more information, see You can easily create subscription services on LINE! What is the "Membership" feature of the LINE Official Account? (opens new window) (only available in Japanese) in LINE for Business.

Currently, the membership feature is only available for LINE Official Accounts in Japan.

# Get a user's membership subscription status

This endpoint allows you to get information about the memberships to which the user specified by the user ID is subscribed. For more information, see Get a user's membership subscription status in the Messaging API reference.

# Get membership plans being offered

This endpoint allows you to get the membership plans that are currently being offered through your LINE Official Account membership. For more information, see Get membership plans being offered in the Messaging API reference.

On LINE version 14.3.0 or later, shortcuts to your LINE MINI App can now be added from the action button
2024/03/07

On LINE version 14.3.0, Add to Home Screen has been added to the action button options in the LINE MINI App.

Tapping Add to Home Screen will display the Add Shortcut screen like using the liff.createShortcutOnHomeScreen() method.

With this, in all LINE MINI Apps, users can now add a shortcut to a LINE MINI App to the home screen of the user's device.

For more information about shortcuts to your LINE MINI App, see Add a shortcut to your LINE MINI App to the home screen of the user's device in the LINE MINI App documentation.

In Indonesia, some features of the Messaging API will be discontinued on April 3, 2024
2024/02/29

We'd like to inform you that due to a change in strategy for the LINE Official Accounts in Indonesia, some features of the Messaging API will be discontinued.

# Scheduled date of change

April 3, 2024

The details and date of this specification change are subject to change without notice.

# Changes

As a result of this specification change, the following features will no longer be available in Indonesia:

  1. Getting friend demographics
  2. Specifying the target of narrowcast messages by region to be sent
  3. Sending messages via LINE notification message
  4. Using LINE Beacons

# 1. Getting friend demographics

In the Get friend demographics endpoint in the Insight section, the LINE Official Accounts created by Indonesian users will no longer be able to get demographics.

# 2. Specifying the target of narrowcast messages by region to be sent

You will no longer be able to specify Indonesia as a region in the demographic filter object for narrowcast messages.

# 3. Sending messages via LINE notification message

Messages can't be sent to phone numbers issued in Indonesia in LINE notification message, which are only available to corporate customers.

# 4. Using LINE Beacons

LINE Beacons will no longer be available in Indonesia. After the specification change, beacon devices will no longer be able to detect Indonesian users.

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

[Resolved] Notice about service outage for the Messaging API
2024/02/27

We'd like to inform you about a service outage regarding the Messaging API. The issue has now been resolved.

We sincerely apologize for any inconvenience that this may have caused.

# Date and time of outage

February 27, 2024 around 12:37 - around 13:17 (UTC+9)

# Cause of the outage

Server failure

# Impact

# Details

During the stated date and time, some requests for messages containing stickers or LINE emoji may not have been processed properly, resulting in an error with status code 5xx.

We will continue to improve the quality of its services to prevent future outages. Thank you for your understanding.

[Resolved] Notice about service outage for the LINE Platform
2024/02/16

We'd like to inform you about a service outage regarding the LINE Platform. The issue has now been resolved. We sincerely apologize for any inconvenience that this may have caused.

# Date and time of outage

February 14, 2024 around 17:00 - around 17:10 (UTC+9)

# Cause of the outage

Server failure

# Impact

  • Messaging API
  • LINE Login
  • LIFF/LINE MINI App
  • LINE Developers Console
  • Other LINE Platform services corresponding to the following domain names
    • api.line.me
    • access.line.me

# Details

These are the main impacts per product:

# Messaging API

Some requests weren't processed properly.

Due to this outage, the messages that weren't properly sent even if the API requests succeeded, won't be counted as the LINE Official Account usage fees and the "number of sent messages" that can be confirmed in some way such as the Get number of sent push messages endpoint.

# LINE Login

There were instances where LINE Login didn't work per usual.

# LIFF/LINE MINI App

There were instances where LIFF/LINE MINI App couldn't be used per usual.

# LINE Developers Console

There were instances where some features of the LINE Developers Console couldn't be used per usual.


When an outage occurs, we post a preliminary report on the LINE API Status. For more information, see the news from April 5, 2021, LINE API Status site for checking service availability opened.

We will continue to improve the quality of its services to prevent future outages. Thank you for your understanding.

LIFF v2.23.2 released
2024/02/15

We've released LIFF v2.23.2.

In LIFF v2.23.2, we've made the following improvement and a bug fix.

# The cause of the LIFF SDK loading failures can now be checked in a log and LiffError

When the LIFF SDK fails to load, the cause can now be checked in a console log or in the cause property of the LiffError object.

# We've fixed a bug that caused some parameters of the URL fragment to be unintentionally removed when initializing a LIFF app

In LIFF apps, for security reasons, the following string-keyed parameters are removed from the URL fragment of the primary redirect URL at the time the liff.init() method is resolved.

  • access_token
  • client_id
  • context_token
  • feature_token
  • id_token

There was a bug that caused parameters whose keys were strings ending with these strings (e.g. prefix_access_token) to be unintentionally removed from the URL fragment. In v2.23.2, we've fixed the bug so that only parameters keyed by the above strings are be removed.

# How to update to LIFF v2.23.2

If you're using the CDN edge path (https://static.line-scdn.net/liff/edge/2/sdk.js), you'll automatically update LIFF to v2.23.2.

If you're using an npm package, you can update to v2.23.2 by executing either npm install @line/liff@2.23.2 or yarn add @line/liff@2.23.2.

For more information on integrating the LIFF SDK, see Integrating the LIFF SDK with the LIFF app in the LIFF documentation.

LINE MINI Apps can now be used by non-LINE users outside of Japan, Thailand and Taiwan via a web browser
2024/02/14

LINE MINI Apps can now be used by non-LINE users outside of Japan, Thailand and Taiwan via a web browser. This means, for example, that foreign visitors to Japan who don't use LINE app can now use the services of LINE MINI Apps via a web browser without having to install the LINE app.

For more information, see Redirect non-LINE users to a web browser in the LINE MINI App documentation.

# Specification change date

February 14, 2024

# Changes

In the LINE Developers Console, if you enable Redirect non-LINE users to a web browser in the LIFF tab of the LINE MINI App channel, non-LINE users outside of Japan, Thailand and Taiwan can use the LINE MINI App service via a web browser.

When a non-LINE user opens the LINE MINI App in a web browser, the page shown in the figure below will be displayed. Tap Open in browser on the page and the LIFF endpoint URL will open in their web browser.

# Notes

The display in a web browser is enabled only if the language setting of the user's web browser isn't Japanese, Thai or Traditional Chinese. However, if the LINE app is installed on the user's device, the LINE app may be launched and the user may be redirected to the LINE MINI App.

[Updated] In the Messaging API, you can now retrieve information about your LINE Official Account membership
2024/02/09
Added on March 28, 2024

The endpoints for retrieving membership information, which we had suspended since February 14, 2024, are now available again. Note that some specifications, such as endpoint URLs, have been changed.

Added on February 14, 2024

Due to a technical issue, we suspended the endpoints for retrieving membership information via the Messaging API.

We sincerely apologize for any inconvenience this may have caused. We will notify you through this news article once the issue is fixed and the feature has been enabled again.

In the Messaging API, you can now retrieve information about your LINE Official Account membership.

Membership (opens new window) (only available in Japanese) is a monthly membership subscription feature available for the LINE Official Account. Users can subscribe to the membership plan on your LINE Official Account to receive exclusive member perks.

The following two endpoints have been added to the Messaging API:

How to start a membership

You can set up and publish your membership on the LINE Official Account Manager (opens new window). For more information, see You can easily create subscription services on LINE! What is the "Membership" feature of the LINE Official Account? (opens new window) (only available in Japanese) in LINE for Business.

Currently, the membership feature is only available for LINE Official Accounts in Japan.

# Get a user's membership subscription status

Added on March 28, 2024

This endpoint, which we had suspended since February 14, 2024, are now available again. Note that some specifications, such as endpoint URLs, have been changed.

This endpoint allows you to get information about the memberships to which the user specified by the user ID is subscribed. For more information, see Get a user's membership subscription status in the Messaging API reference.

# Get membership plans being offered

Added on March 28, 2024

This endpoint, which we had suspended since February 14, 2024, are now available again. Note that some specifications, such as endpoint URLs, have been changed.

This endpoint allows you to get the membership plans that are currently being offered through your LINE Official Account membership. For more information, see Get membership plans being offered in the Messaging API reference.

In the Messaging API, you can now determine whether a user has added your LINE Official Account as a friend or unblocked by a webhook follow event
2024/02/06

In the Messaging API, you can now determine whether a user has added your LINE Official Account as a friend or unblocked by a webhook follow event.

When a user adds a LINE Official Account as a friend or unblocked, a follow event is sent by webhook. Previously, it was not possible to determine whether "add friend" or "unblock" based on this follow event alone.

With the addition of the follow.isUnblocked property to the follow event, it is now possible to determine whether a user has friended a LINE Official Account for the first time or if the user has previously friended and blocked the account and then unblocked.

This allows you to send special coupons to users only when they add your LINE Official Account as a friend for the first time, or change the content of the reply message between "add friend" and "unblock".

Example of a follow event when a user has unblocked the LINE Official Account:

{
  "destination": "xxxxxxxxxx",
  "events": [
    {
      "replyToken": "nHuyWiB7yP5Zw52FIkcQobQuGDXCTA",
      "type": "follow",
      "mode": "active",
      "timestamp": 1462629479859,
      "source": {
        "type": "user",
        "userId": "U4af4980629..."
      },
      "webhookEventId": "01FZ74A0TDDPYRVKNK77XKC3ZR",
      "deliveryContext": {
        "isRedelivery": false
      },
      "follow": {
        "isUnblocked": true // User has unblocked the LINE Official Account
      }
    }
  ]
}

For more information, see Follow event in the Messaging API reference.

# LINE Messaging API SDK Updates

For more information about the update status of each SDK release related to the above, see the LINE Messaging API SDK release notes.

In the Messaging API, the action has been added to allow users to easily copy text to the clipboard
2024/02/05

In the Messaging API, we've added the clipboard action for users to copy text to the clipboard. This new feature allows users to more easily copy coupon codes and other text.

# Copy text to the clipboard

Specify a clipboard action to controls such as buttons in the message and the rich menu. When a user taps a control, the text specified in the clipboardText property of the clipboard action is copied to the device clipboard.

Example of a push message request using the clipboard action:

curl -v -X POST https://api.line.me/v2/bot/message/push \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {channel access token}' \
-d '{
    "to": "U4af4980629...",
     "messages":[
      {
        "type": "template",
        "altText": "This is your coupon code.",
        "template": {
          "type": "buttons",
          "thumbnailImageUrl": "{your coupon image}",
          "imageAspectRatio": "rectangle",
          "imageSize": "cover",
          "imageBackgroundColor": "#FFFFFF",
          "title": "Your exclusive coupon!",
          "text": "Period: Feb 2024.\nCopy and use the code from the button.",
          "actions": [
            {
              "type": "clipboard",
              "label": "Copy",
              "clipboardText": "3B48740B"  // Specify text to be copied to the clipboard
            }
          ]
        }
      }
    ]
}'

For more information, see Clipboard action in the Messaging API reference.

# Target version

These added features are available on LINE version 14.0.0 or later for iOS or Android.

Shortcuts to your LINE MINI App can now be added to the home screen of the user's device
2024/02/01

Shortcuts to your LINE MINI App can now be added to the home screen of the user's device.

Using the liff.createShortcutOnHomeScreen() method will display the Add Shortcut screen. The user can add a shortcut to your LINE MINI App to the home screen of the user's device by following the instructions on the screen. This allows the user to access your LINE MINI App directly from the home screen of the user's device.

Using this feature for services that users frequently use, such as membership cards and mobile ordering, can improve the user experience.

For more information, see Add a shortcut to your LINE MINI App to the home screen of the user's device in the LINE MINI App documentation.

Revision of the Usage Guidelines for the LINE Social Plugin
2024/01/18

We're planning to revise the Usage Guidelines for the LINE Social Plugin on February 1, 2024.

Content to be revised: Deletion of the "Inquiries" clause

With this revision, we'll no longer accept email requests.

We'll continue to work to further improve its service to our customers. Thank you for your understanding.

[Updated] LIFF v2.23.1 released
2024/01/15
Updated on January 23, 2024

Due to a bug that caused a decrease in the reading accuracy of 2D codes in some devices, the liff.scanCodeV2() method has been reverted to the state before this release. There is no need to update the LIFF SDK or modify the code in your LIFF apps. We apologize for any inconvenience.

We've released LIFF v2.23.1.

In LIFF v2.23.1, we've made the following improvement. We've also made changes to the internal behavior of the LIFF SDK to improve security.

# We've improved the reading accuracy of the liff.scanCodeV2() method

We've improved the reading accuracy of 2D codes in the liff.scanCodeV2() method. Note that the reading accuracy depends on the camera performance of a device, so there may not be a noticeable improvement depending on the user's device.

This improvement is automatically applied to all LIFF apps, so there is no need to update the LIFF SDK or modify the code in your LIFF apps.

# How to update to LIFF v2.23.1

If you're using the CDN edge path (https://static.line-scdn.net/liff/edge/2/sdk.js), you'll automatically update LIFF to v2.23.1.

If you're using an npm package, you can update to v2.23.1 by executing either npm install @line/liff@2.23.1 or yarn add @line/liff@2.23.1.

For more information on integrating the LIFF SDK, see Integrating the LIFF SDK with the LIFF app in the LIFF documentation.

Messaging API maintenance notice
2024/01/11

Maintenance is scheduled for the Messaging API. We sincerely apologize for any inconvenience that this may cause and thank you for your understanding.

# Date and time of maintenance

January 23, 2024 around 21:00 - January 24, 2024 around 0:00 (UTC+9)

Note that the end time of the maintenance may change without notice.

# Impact

Due to this maintenance, aggregation for January 23, 2024, may be delayed on the following endpoints.

Users can now access recently used LINE MINI Apps from the LINE Home tab
2024/01/09

As announced on November 29, 2023, users can now access recently used LINE MINI Apps from the LINE Home tab.

When a user uses a LINE MINI App, the LINE MINI App is displayed in usage history of LINE MINI Apps in the Home tab > Services. This allows users to easily access your LINE MINI App from the Home tab.

# Date of the change

January 9, 2024

# Target version

  • LINE for iOS version 13.19.0 or later
  • LINE for Android version 13.19.0 or later

# Changes

The LINE MINI Apps that users can access from the LINE Home tab have changed as follows:

Before change After change (current)
LINE MINI Apps pinned to the Home tab by the user LINE MINI Apps recently used by the user

With this change, the LINE MINI Apps that were pinned to the Home tab have been removed in all LINE versions.