Skip to content

Promote tours and events

This guide describes how to configure Label theme to display details about your store's tour dates and events.

Use this feature to promote tour dates and events on your store's pages.

A tour and events list displayed on an example homepage.

In the previous image, a Tours and events section is displayed on a store's home page. Inside the section, details about the store's upcoming events are displayed.

Page templates, sections and blocks for events

The following describes Label's page templates, sections and blocks that you can use for displaying your store's tour dates and events.

Tour and events section

Label's default home page includes a Tour and events section. The section is also included in Label's "tour-events" page template. For information about the section, refer to Tour and events.

Note

In Theme editor, you can add a Tour and events section to any store page except Checkout and Giftcard pages.

Inside a Tour and events section, you add "Event" blocks. In an Event block, you Enter tour and event details manually. Then, the section displays the event details inside the block.

Alternatively, you configure a Tour and events section to retrieve event details from the Bandsintown or EventBrite external services. Then, the section displays the event details retrieved from an external service.

Note

If you enter event details manually, events from external services are not displayed.

Tour and events from page section

Label theme includes a "Tour and events from page" section. The section displays events that are retrieved from your store's "tour and events" page. For information about the section, refer to Tour and events from page.

To use the section to display events from your store's Tour and events page, refer to Display events from a tour and events page.

Enter event details manually

In a Tour and events section, to add event details into an Event block manually:

  1. On your store's admin page, navigate to Sales channels > Online store > Themes.

  2. On the Themes page, locate the theme you require, and then select Customize.

    The Theme page in Shopify admin

  3. From the dropdown at the top of the page, select a page that contains a Tour and events section.

    Note

    To add the section to the current page, select Add section, and then choose Tour and events. The section is enabled on the home page, and the tour-events page template, by default.

  4. From the side menu, expand the Tour and events section menu

    The Tour and events section selected in Theme editor.

  5. In the section menu, select Add event (block).

    The add event block option inside the Tour and events section in Theme editor.

  6. Select the Event block you added.

    An event block in the Tour and events section in Theme editor.

  7. In the Event block menu, adjust the settings described in the following table to provide details about your event.

Setting nameDescription
DayAdjust the Day slider to set a date to display for the event inside the block. The slider values range from 1 to 31.
MonthUse the Month dropdown to set a month to display for the event inside the block. The options are from January to December.
LocationIn the Location box, enter text to display as a location for the event inside the block.
Location > Connect dynamic sourceTo display a location from a dynamic source, select the Connect dynamic source icon beside the Location box, and then choose a metafield to add. Refer to Shopify help: Metafields.
VenueIn the Venue box, enter text to display as a venue for the event inside the block.
Venue > Connect dynamic sourceTo display a venue from a dynamic source, select the Connect dynamic source icon beside the Venue box, and then choose a metafield to add. Refer to Shopify help: Metafields.
Ticket URLIn the Ticket URL box, enter a URL for purchasing tickets to the event or select a store page to link to. To remove a link, select the X icon inside the text box.
Ticket URL > Connect dynamic sourceTo display a Ticket URL from a dynamic source, select the Connect dynamic source icon beside the Ticket URL box, and then choose a metafield to add. Refer to Shopify help: Metafields.
End date > This event has an end dateSelect the checkbox This event has an end date to turn on/off using an end date for the block's event. With this option enabled, you can specify a date when the block's event ends.
End date > DayAdjust the Day slider to set a date to display as an end date for the event inside the block. The slider values range from 1 to 31.
End date > MonthUse the Month dropdown to set a month to display as an end date for the event inside the block. The options are from January to December.
Remove blockSelect Remove block to delete the block from the current section.

Retrieve Bandsintown events

To configure a Tour and events section to retrieve details about events from Bandsintown, you need your Bandsintown artist name. Then, add your Bandsintown artist name into the section.

To get your Bandsintown artist name, and then use it to display Bandsintown events inside the section:

  1. Go to Bandsintown, and then sign into your Bandsintown user account.

  2. In the URL for your artist's page, locate your Bandsintown artist's name.

    For example:

    • If an artist's page URL is https://www.bandsintown.com/a/25874-radiohead
    • The URL suffix 25874-radiohead is the Bandsintown artist name.
  3. On your store's admin page, navigate to Sales channels > Online store > Themes.

  4. On the Themes page, locate the theme you require, and then select Customize.

    The Theme page in Shopify admin

  5. From the dropdown at the top of the page, select a page that contains a Tour and events section.

    Note

    To add the section to the current page, select Add section, and then choose Tour and events. The section is enabled on the home page, and the tour-events page template, by default.

  6. From the side menu, select the Tour and events section.

    The Tour and events section in the Theme editor menu.

  7. In the Tour and events section menu, locate the External source area.

  8. Set the Source to Bandsintown.

  9. In the Bandsintown artist name text box, enter your Bandsintown artist name. For example, enter 25874-radiohead.

    The options for adding Bandsintown to a Tour and events section in the Theme editor menu.

  10. Select Save.

Retrieve EventBrite events

To configure a Tour and events section to retrieve and display details about events from EventBrite, you need an EventBrite token. You add your EventBrite token into the section. The token authorizes Label to connect to your EventBrite user account to retrieve and display details about events from EventBrite.

To find and authorize your EventBrite token, and then add it into the section:

  1. Go to http://www.switchthemes.co/eventbrite, and then select Grab your Access Token.

    The Grab your Access Token webpage.

  2. Sign into your EventBrite user account.

  3. When promoted to allow Switch themes to access your EventBrite user account, select Allow.

    The allow access webpage

  4. Copy your EventBrite token to your computer's clipboard.

    An EventBrite Access Token displayed on a webpage

  5. On your store's admin page, navigate to Sales channels > Online store > Themes.

  6. On the Themes page, locate the theme you require, and then select Customize.

    The Theme page in Shopify admin

  7. From the dropdown at the top of the page, select a page that contains a Tour and events section.

    Note

    To add the section to the current page, select Add section, and then choose Tour and events. The section is enabled on the home page, and the tour-events page template, by default.

  8. From the side menu, select the Tour and events section.

    The Tour and events section in the Theme editor menu.

  9. In the Tour and events section menu, locate the External source area.

  10. Set the Source to EventBrite.

  11. In the Eventbrite token box, paste the token you copied previously.

    The options for adding Eventbrite to a Tour and events section in the Theme editor menu.

  12. Select Save.

Display events from a tour and events page

Label theme includes a "Tour and events from page" section. Use the section to display events from a Tour and events page. For information about the section, refer to Tour and events from page.

To use the Tour and events from page section, your store requires:

  • A "source" page that contains an event you want to display.
  • A "target" page to display the event from your source page.

To configure a target page to display events from a source page, refer to Configure your target and source pages.

Example target and source pages in Theme editor.

The upper half of the previous image shows a store's Example page in Theme editor. The example page is the store's "source" page. Theme editor's menu, in the upper left, shows the tour-event template assigned to the example page. The page also contains a Tours and events section. In the upper right, the section's Event block settings are configured with details about an upcoming store event.

The lower half of the previous image shows a store's home page in Theme editor. The home page is the store's "target" page. The home page contains a Tours and events from page section. On the right, the section's Page selector is set to the Example page. On the home page, details about an upcoming store event are displayed inside the section. These event details are retrieved from the Example page.

Configure your target and source pages

To display events on the target page from a source page, complete the following steps.

  1. On your store's admin page, select Sales channels > Online store > Pages.

  2. Select your required source page from the Pages list. Alternatively, to create a new page, select Add page, and then select the page you created.

    For example, in the following image, the Example page is selected.

    The Pages list in Shopify admin

  3. Use the Theme template dropdown to select the tour-events template.

    A example pages in Shopify admin with the tour-events template selected

  4. Select Save to assign the tour-events page template to your source page.

    Note

    To learn about pages, refer to Shopify help: Pages.

  5. In Theme editor, at the top of the page, use the dropdown to select your target page.

  6. From the side menu, select Add section, and then choose Tour and events from page.

    The option to add a Tour and events from page section selected in Theme editor.

  7. Select the Tour and events from page section you added.

    A Tour and events from page section selected in Theme editor.

  8. In the section's settings, use the Page selector to choose your source page.

    The Page selector inside a Tour and events from page section selected in Theme editor.

    Note

    [Optional] In the section setting's, you can also Specify a source Section ID.

  9. Select Save.

Specify a source Section ID

WARNING

The following steps are recommended for expert users only.

Use your browser's Web inspector tool to get a Section ID for your source. Then, in your target page's Tour and events from page section settings, add the Section ID. Refer to Use web inspector.

To find and add a Section ID, complete the following steps:

  1. In Theme editor, preview your source page.

  2. Use your browser's Web inspector tool to locate the <section> HTML element for the Tour and events section.

  3. Locate the element's data-section-id attribute, and then copy the attribute's value to your computer's clipboard.

    For example, in the following image, the Web inspector tool shows the data-section-id attribute's value is template--16419464183993__main.

    A browser's Web inspector tool showing a data-section-id attribute's value.

    Note

    The <section> element has a parent <div> element with an id attribute. In the <div>, ignore the suffixed shopify-section- portion of the attribute's value.

    For example:

    • if the <div> element's id attribute has the value shopify-section-template--16419464183993__main

    • the value you copy is template--16419464183993__main

  4. In Theme editor, open your target page.

  5. From the side menu, select the Tour and events from page section.

    A Tour and events from page section selected in Theme editor.

  6. In the Tour and events section ID box, paste the value you copied previously.

    The Tour and events section ID box in Theme editor.

  7. Select Save.

Note

Providing a Section ID is optional, but recommended.

Data for an entire store page includes elements like the header, footer, and other sections. Data for a specific section excludes these elements. This means less data are required to render a section than an entire page.

If you provide a Section ID, Label only requests data for the section that you specify from the Section Rendering API. If you do not provide a Section ID, Label retrieves your entire source page from the API.

Providing a Section ID helps Label render events from your source page more quickly.