--- layout: home title: Select2 - The jQuery replacement for select boxes slug: home ---

# Select2

The jQuery replacement for select boxes

Download

Version 4.0.0-beta.3

Looking for the Select2 3.5.2 docs? We have moved them to a new location while we push forward with Select2 4.0.
Select2 gives you a customizable select box with support for searching, tagging, remote data sets, infinite scrolling, and many other highly used options.

## Getting started with Select2

In order to use Select2, you must include the JavaScript and CSS file on your website. You can get these files built for you from many different locations.

### Using Select2 from a CDN

Select2 is hosted on both the cdnjs and jsDelivr CDNs, allowing you to quickly include Select2 on your website.

1. Include the following lines of code in the `<head>` section of your HTML.

       <link href="//cdnjs.cloudflare.com/ajax/libs/select2/4.0.0-beta.3/css/select2.min.css" rel="stylesheet" />
       <script src="//cdnjs.cloudflare.com/ajax/libs/select2/4.0.0-beta.3/js/select2.min.js"></script>

   Immediately following a new release, it takes some time for CDNs to catch up and get the new versions live on the CDN.
2. Initialize Select2 on the `<select>` element that you want to make awesome.

       <script type="text/javascript">
         $('select').select2();
       </script>

3. Check out the examples page to start using the additional features of Select2.

### Downloading the code locally

In some situations, you can't use Select2 from a CDN and you must include the files through your own static file servers.

1. Download the code from GitHub and copy the `dist` directory to your project.
2. Include the following lines of code in the `<head>` section of your HTML.

       <link href="path/to/select2.min.css" rel="stylesheet" />
       <script src="path/to/select2.min.js"></script>

3. Check out the examples page to start using the additional features of Select2.

## The different Select2 builds

Select2 provides multiple builds that are tailored to different environments where it is going to be used. If you think you need to use Select2 in a nonstandard environment, like when you are using AMD, you should read over the list below.

Build name | When you should use it
--- | ---
Standard (`select2.js` / `select2.min.js`) | This is the build that most people should be using for Select2. It includes the most commonly used features.
Full (`select2.full.js` / `select2.full.min.js`) | You should only use this build if you need the additional features from Select2, like the compatibility modules or recommended includes like jquery.mousewheel
AMD (`select2.amd.js` / `select2.amd.full.js`) | This is the build that anyone who is using Select2 with an existing AMD build system should use. It is also recommended that you read the AMD compatibility documentation to avoid any unexpected issues.

## About

- Source code, hosted on GitHub
- Bug tracker
- Community and support