QR Codes and Short Links

WhatsApp QR codes and short links create a digital doorstep for businesses, enabling them to stay connected with their existing customers and connect with new ones. This way, customers can simply scan QR codes with their mobile device camera or type in a short link to begin a conversation, without needing to input a phone number.

You can view, create, edit and delete QR codes and short links in the Business Management API or in the Business Manager UI.

Limitations

  • A single WABA phone number cannot be associated with more than 2,000 QR codes and short links.
  • A QR code scan can initiate a pre-filled message containing up to 140 characters of text.
  • Analytics are not available for QR Codes and Short Links as we limit the amount of data we log to protect user privacy.

Managing QR Codes and Short Links

Getting List of QR Codes and Short Links

To use the WhatsApp Business Management API to get a list of existing QR codes, see the Retrieve a List of QR Code Messages documentation. To use the Business Manager to get a list of existing QR codes, see the Help Center article.

Deleting

To use the WhatsApp Business Management API to delete QR codes, see the Delete a QR Code Message documentation. To use the Business Manager to delete QR codes, see the Help Center article.

Prefilled Messages

QR codes and short links can be programmed to populate a prefilled message to provide context for conversations. Prefilled messages can contain up to 140 characters of text. These messages are fully customizable and can be updated or deleted at any time.

User Experience

User ScenarioExpected Behavior

User tries to access a code or link that has been deleted.

User sees an error message saying "This QR code [short link] has expired".

User scans the QR code or types in the short link of a business they previously blocked.

User gets a prompt asking if they would like to unblock the business to continue messaging them.

User clicks a short link on a desktop browser.

Conversation is launched within the desktop client. If there is no client installed, user is prompted to install it.

Best Practices

Format

We recommend outputting the QR code as a scalable vector graphic (.svg) file. You can resize your QR Code to develop product packaging, signage, etc.

Appearance

While we do not offer the capability to natively customize QR codes, you can do so by downloading and editing QR codes with the software of your choice. We recommend you do not customize the color or look and feel of the code itself in order to preserve readability.

Additionally, refer to WhatsApp brand guidelines at https://whatsappbrand.com.

FAQs

You can view, create, edit and delete QR codes and short links in the Business Management API or in the Business Manager UI.
A single WABA phone number cannot be associated with more than 2,000 QR codes and short links.

We recommend the .svg file format for the best quality in print materials.

The new short links enable prefilled messages associated with a link to be edited or deleted at any time. They also reduce the syntax of the URL to a random code, which eliminates the need to embed messages in the URL and masks the phone number.

If the user has the WhatsApp desktop client installed, it will launch a conversation with your business. If not, the user will be prompted to install the WhatsApp desktop client.

If a user tries to access a QR code or short link that has been deleted, they will see an error message indicating the QR code/short link has expired.

QR codes can now be generated and managed directly within the WhatsApp Business Management API and users can scan them with their WhatsApp, iOS, or Android camera.

In addition, with WhatsApp QR codes

  • Prefilled messages are fully customizable and can be changed or deleted at any time,
  • Users will always go directly to the app without any interstitial page, and
  • The in-app experience for an expired code sends the user a clear message.

You will be responsible for using the appropriate QR code based on expected location and language of users.

Analytics are not available for QR Codes and Short Links as we limit the amount of data we log to protect user privacy.