Included in this page is the HTML select/dropdown code snippets to generate a list of states for the United States. The list uses the USPS state abbreviation values. A list of outlying territories and armed forces USPS entries are also available

[ This description is mirrored from at on 2018-12-05 ]

Build Status

Sauce Test Status

Sauce Test Status

Published on

Demo and API docs

usa-state-list is similar to a native browser select element. usa-state-list works with selectable content. The currently selected item is displayed in the control. If no item is selected, the label is displayed instead.

State drop down list that will include states, outlying territories, armed forces. Example: It includes an optional label, error message, invalid, autovalidate and required attributes.

<usa-state-list file-name="jsonFile"></usa-state-list>
<usa-state-list label="label"></usa-state-list>
<usa-state-list error-message="state is required"></usa-state-list>
<usa-state-list invalid="boolean value"></usa-state-list>
<usa-state-list autoValidate="boolean value"></usa-state-list>
<usa-state-list required="boolean value"></usa-state-list>


If the auto-validate attribute is set, element validates when the user not select the state from dropdown menu.


Install the component using Bower:

bower install --save biztek/usa-state-list


Import Custom Element:

<link rel="import" href="bower_components/usa-state-list/usa-state-list.html">

And then use it:

<usa-state-list file-name="jsonFile"></usa-state-list>


  1. Fork it!
  2. Create your feature branch: git checkout -b usa-state-list
  3. Commit your changes: git commit -m 'Add some feature'
  4. Push to the branch: git push -u origin usa-state-list
  5. Submit a pull request


Licensed under the Apache 2.0.


Link to this version
ImportedReleased 08 September 2017Other
Framework Support
Polymer 1.0+
Browser Independent
Install with
Release notes - Version 1.0.8



  • PolymerElements/paper-dropdown-menu#^1.4.1
  • PolymerElements/paper-listbox#^1.1.2
  • PolymerElements/paper-item#^1.2.1