Angular component to integrate LiveChat with your single-page app


stars 🌟issues ⚠️updated 🛠created 🐣size 🏋️‍♀️
2419Jun 11, 2021Aug 31, 2017Minified + gzip package size for @livechat/angular-widget in KB


Livechat Widget for Angular

Library to integrate LiveChat Widget with your Angular App.


StackBlitz live example.


npm install --save @livechat/angular-widget


Import LivechatWidgetModule in Angular AppModule.
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';
import { LivechatWidgetModule } from '@livechat/angular-widget'

  declarations: [
  imports: [
  providers: [],
  bootstrap: [
export class AppModule { }
Use the LiveChat Angular Widget in your template:
<livechat-widget licenseId="10073628"></livechat-widget>

As optional parameters, you can define:

  • group
  • chatBetweenGroups
  • params
  • visitor
  • gaVersion

To get more details about usage of the optional paramteres please read our tracking code documentation.

Access to the LiveChat Widget API using callback method
<livechat-widget licenseId="10073628" (onChatLoaded)="onChatLoaded($event)"></livechat-widget>
import { Component } from '@angular/core';
import { LiveChatWidgetApiModel } from '@livechat/angular-widget';

  selector: 'app-root',
  templateUrl: './app.component.html',
export class AppComponent {
  liveChatApi: LiveChatWidgetApiModel

  constructor() { }

  onChatLoaded(api: LiveChatWidgetApiModel) {
    this.liveChatApi = api;
Access to the LiveChat Widget API using @ViewChild decorator
<livechat-widget #liveChatWidget licenseId="10073628" ></livechat-widget>
import { Component, ViewChild, OnInit, OnDestroy } from '@angular/core';
import { LiveChatWidgetModel } from '@livechat/angular-widget';
import { Subscription } from 'rxjs';

  selector: 'app-root',
  templateUrl: './app.component.html',
export class AppComponent implements OnInit, OnDestroy {
  @ViewChild('liveChatWidget') liveChatWidget: LiveChatWidgetModel;
  liveChatWidget$: Subscription = new Subscription();
  liveChatApi: LiveChatWidgetApiModel;

  constructor() { }

  ngOnInit(): void {
    this.liveChatWidget$ = this.liveChatWidget.onChatLoaded.subscribe((api: LiveChatWidgetApiModel) => this.liveChatApi = api)

  ngOnDestroy(): void {

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.