TIP: Try navigating through list using left & right arrow keys


Ultra lightweight, usable, beautiful autocomplete with zero dependencies.

Github issues
Github stars
3 days ago
Github last update date
NPM current week downloads


npm version Build Status Code Climate Test Coverage


Awesomplete is an ultra lightweight, customizable, simple autocomplete widget with zero dependencies, built with modern standards for modern browsers.


There are a few ways to obtain the needed files. Here are 2 of them: 1. CDN server

  1. Another way to get up and running is by using yarn or npm:
yarn add awesomplete
npm install awesomplete --save

More information about the npm package can be found here.

Basic Usage

Before you try anything, you need to include awesomplete.css and awesomplete.js in your page, via the usual tags:

<link rel="stylesheet" href="awesomplete.css" />
<script src="awesomplete.js" async></script>

Then you can add an Awesomplete widget by adding the following input tag:

<input class="awesomplete"
       data-list="Ada, Java, JavaScript, Brainfuck, LOLCODE, Node.js, Ruby on Rails" />

Add class="awesomplete" for it to be automatically processed (you can still specify many options via HTML attributes) Otherwise you can instantiate with a few lines of JS code, which allow for more customization.

There are many ways to link an input to a list of suggestions. The simple example above could have also been made with the following markup, which provides a nice native fallback in case the script doesnbt load:

<input class="awesomplete" list="mylist" />
<datalist id="mylist">
	<option>Ruby on Rails</option>

Or the following, if you donbt want to use a <datalist>, or if you donbt want to use IDs (since any selector will work in data-list):

<input class="awesomplete" data-list="#mylist" />
<ul id="mylist">
	<li>Ruby on Rails</li>

There are multiple customizations and properties able to be instantiated within the JS. Libraries and definitions of the properties are available in the Links below.


JS PropertyHTML AttributeDescriptionValueDefault
listdata-listWhere to find the list of suggestions.Array of strings, HTML element, CSS selector (no groups, i.e. no commas), String containing a comma-separated list of itemsN/A
minCharsdata-mincharsMinimum characters the user has to type before the autocomplete popup shows up.Number2
maxItemsdata-maxitemsMaximum number of suggestions to display.Number10
autoFirstdata-autofirstShould the first element be automaticallyBooleanfalse
listLabeldata-listlabelDenotes a label to be used as aria-label on the generated autocomplete list.StringResults List


Awesomplete is released under the MIT License. See LICENSE file for details.


The official site for the library is at https://leaverou.github.io/awesomplete/.

Documentation for the API and other topics is at https://leaverou.github.io/awesomplete/#api.

Created by Lea Verou and other fantastic contributors.

Buy us a coffeeBuy us a coffee