Image_Back_02.png

Widget Customization

events widget customization options

Customizing your widget is easy: look for the setting you would like to change in the table below, grab the corresponding HTML5 attribute, add it to your widget code snippet with the desired valued, and save your modifications. You’re all set! If you would like even more customization, you can use the Bandsintown Events API.

Setting Name

HTML5 Attribute

Description

Default

Artist Name

data-artist-name

Your Bandsintown artist ID or artist page name. For the ID, please use the format id_{your_artist_id} e.g. id_1120421.

None

Text Color

data-text-color

Text color for the event data. HTML color code (hex or name).

#000000

Link Color

data-link-color

Color for the “upcoming” / “past events” links as well as the event buttons. HTML color code (hex or name).

#000000

Link Text Color

data-link-text-color

Text color for the event buttons. HTML color code (hex or name).

#FFFFFF

Background Color

data-background-color

Background color for the widget. HTML color code (hex or name).

Transparent

Popup Background Color

data-popup-background-color

Popup background color for the widget. HTML color code (hex or name).

#FFFFFF

Separator Color

data-separator-color

Color for the separators between events in the list. HTML color code (hex or name).

#7C7C7C

Font

data-font

Font for the widget.

Helvetica

Widget Width

data-widget-width

Width in pixels or percentage. Width in CSS format is "350px" or "50%". Switches to mobile friendly layout at 414px.

100%

Display Logo

data-display-logo

Display the Bandsintown logo at the top of the widget (links to the artist's Bandsintown page).

true

Display Track Link

data-display-track-button

Display Track message at the top of the widget (links to the artist's Bandsintown page and tracks the artist when clicked).

true

Display Play My City Button

data-display-play-my-city

Display Play My City button at the bottom of the widget (collects user location data when clicked).

true

Display Local Dates

data-display-local-dates

If set to true, the browser will prompt the user for location information and show local events at the top of the event list.

false

Display Past Dates

data-display-past-dates

If set to true, shows past dates in addition to upcoming dates.

true

Display Start Time

data-display-start-time

If set to true, shows start times next to event dates.

false

Display Lineup

data-display-lineup

If set to true, displays the lineup for each event.

false

Display Details

data-display-details

If set to true, displays the on sale date and description for each event, if information is available.

false

Display Limit

data-display-limit

Number of shows to display. A Show All Dates" link will appear below the concerts to expand the list if the limit is exceeded.

Show all

Language

data-language

If set, the widget will always display in the chosen language. English, Spanish, German, French, Japanese, Portuguese and Italian are supported via the following language codes: en, es, de, fr, ja, pt, it.

Detects browser language

Auto Style

data-auto-style

If set to true, the widget will use the parent page's styling to "guess" at good options for its styling: any additional specified options will take precedence over auto style options.

false

Div ID

data-div-id

Specifies a div for the widget render inside. If not specified, the widget will be rendered in the location of the <a> tag.

None

Facebook Page ID

data-facebook-page-id

Used to lookup an artist by Facebook page ID. If found, the artist with the matching page ID will be used, otherwise the artist name will be used: the data-artist-name property is still required when using this option. Formatted as a number or string.

None

Affiliation Code

data-affil-code

A word to identify your application, company or band. Formatted as a string.

“js_(website domain name)”

App ID

data-app-id

You may specify a word to identify your application, company or band. Formatted as a string.

“js_(website domain name)”