Search

Custom Website Messages for iframes

Rachael Norris
Rachael Norris
  • Updated

In this article, we’ll guide you through how to configure Custom Website Messages which appear on iframes.

iframes are just one of the integration tools you can use to integrate your website with Spektrix. You may use iframes for a part of, or all of, your online journey.

Using Custom Website Messages is one way you can configure iframes.

Before getting started, we recommend you read the following articles:

TIP: You can use the iframes Content Tool to identify which parts of your iframes can be edited and which cannot be changed.

 

What are Custom Website Messages?

Custom Website Messages let you change or add certain lines of text which appear on your iframes. 

For example, you may wish to add extra information to the page which displays your Memberships, or change the title of your Merchandise page. By changing the corresponding Custom Website Message, you can change this message to add information that is specific to your organisation.

Custom Website Messages use Wikitext and this can be used to apply styling to the custom messages you add. To learn more about how Wikitext works, read our article about Website Content.

The content you add in Custom Website Messages will appear on the corresponding iframe across all websites that are linked to your system. This means that if your organisation has multiple websites, you may want to ensure that the content is relevant and helpful for all of your website audiences. 

REMINDER: The changes you can make using Custom Website Messages are limited to the options available. You can configure iframes in other ways by using Website Content, Using Attributes to filter iframes or by asking your Website Developer to remove or change certain elements using CSS Styling for iframes. Otherwise, it may not be possible to edit that part of the iframe.

 

How to edit Custom Website Messages in the Settings Interface

To add Custom Website Messages to different iframes, you’ll need to navigate to the Settings Interface. 

REMINDER: To access the Settings Interface, you’ll need the Settings Administrator user role.

If you are viewing the old Interface, you’ll need to switch to the New Interface by going to the Control Panel and selecting Go to New Interface:

 

 

From the menu across the top, choose Configuration > System Set up:

 

Then choose Custom Website Messages from the menu on the left: 



TIP: There are also Custom Website Messages under the sections Donations on Web, Memberships on Web and Offers on Website.

  • To add a Custom Website Message, type the message you want to add into the box related to the message you want to update. You can then add formatting and images using Wikitext.

REMINDER: If you are using any special characters, such as *, /, \, _, -, $, @, #, %, you will need to put a backslash \ in front of them. If you do not do this, your Custom Website Message will not save.

  • You can preview the Custom Website Message by clicking the Preview link below the text box. The preview will show how your text will display without any CSS styling applied. To preview the iframe with the CSS Styling applied, you can follow the guidance on how to preview iframes in the What are iframes? article.
  • To save your changes, scroll down to the bottom of the page and click the Save Configuration button:

 

 

Custom Website Messages

In this section, we’ll cover each of the Custom Website Messages you can add and where the change will be reflected. 

In this article we’ve listed them in the order they appear in the Settings Interface, however, we’ve also included a list below which you can use to jump to the relevant messages by iframe.

TIP: If you don’t know which Custom Website Message you need to update, you can search this page using Ctrl + F (or Command/⌘ + F on a Mac) to search for a keyword, or, jump to the relevant Custom Message from each of the iframes listed below.

 

Terms and Conditions Check Box

In both Classic and Express Checkout, you can force the Customer to accept the Terms and Conditions of the sale in the Checkout iframe (Checkout.aspx). 

To do this, check the box named Display Terms and Conditions and make customers agree with them by ticking a box before they can proceed.

Then, add the text you want to add into the box marked Enter your Terms and Conditions below. To add any formatting, you'll need to use Wikitext:

 

If you need to supply your Web Developer with guidance, take a look at the details about the Checkout iframe on our Integration Portal.

In order to add a link to your Terms and Conditions that opens in a new page, you'll want to use the following Wikitext:

By checking this box, you agree to our #(newWindow=AddressOfYourT&CsPage)terms and conditions#

Replace the AddressOfYourT&CsPage with the URL of your Terms and Conditions web page. Make sure you include https://www. at the start of the website address.

TIP: You’ll need to check the box and populate the Terms and Conditions text box for this custom message to appear on the Checkout iframe in both classic and express checkout.

 

Priority Booking

When a Customer reaches the Event Details (EventDetails.aspx) or Choose Seats iframe (ChooseSeats.aspx) of an Instance with Priority Booking, you can choose to display a custom message to those who don’t have access to Priority Booking.

For example, you may wish to add a message that upsells access to the Priority Booking period through a Membership.

The custom message for Priority Booking will appear in addition to the default message that says: Online booking for this event opens at [time] on [date]. For priority booking please log in to your account or enter a code below.

Customers who do have access to the Priority Booking period will see the Choose Seats iframe as normal. 

Enter your custom message into the box marked Custom message about priority booking. To add any formatting, you'll need to use Wikitext:

 

Seating Plans

The custom message for Seating Plans will appear on the Choose Seats iframe (ChooseSeats.aspx) above your Seating Plan.

By default, the message above the Seating Plan reads: Please select your seats (maximum [max number] per order).

This is the only Custom Message that cannot be edited with Wikitext. Any text added will be plain text. Any styling from your CSS will be applied as usual.

 

Basket/Cart

The custom message for the Basket/Cart will appear on the Basket/Cart iframe (Basket2.aspx).

Enter your custom message into the box marked Custom message for basket.aspx. To add any formatting, you'll need to use Wikitext.

  •  

 

Log in for discounts

When a Customer reaches the Basket/Cart iframe (Basket2.aspx) and they are not logged in, you can add a custom message to remind them that they might need to log in. This can be useful if you use Offers that are powered by Memberships, as an Offer will not apply until a Customer is logged in.

Enter your custom message into the box marked Custom “login for discount” message to display on basket.aspx. To add any formatting, you'll need to use Wikitext.

REMINDER: This custom message will only appear when a customer is not logged in.

 

Confirmation

When a sale is completed in Classic Checkout, the Customer will reach the confirmation iframe. 

By default, the iframe will show the message: Thank you for your order! We have sent a confirmation email to [email address].

You might want to add a custom message to this page to add some extra information that is specific to your organisation. For example, you could include a message with your Box Office phone number or email address.

This message will also appear on the Customer’s confirmation email. We don’t recommend using Wikitext on this message as it won’t apply in the plain text confirmation email.

Enter your custom message into the box marked Custom message for confirmation.aspx. 

REMINDER: This custom message only works if you are using Classic Checkout.

 

Custom message for loginlogout

The Login Logout iframe (Loginlogout.aspx) will appear if a customer tries to access the My Account iframe (Myaccount.aspx) without first logging in.

Enter your custom message into the box marked Custom message for loginlogout.aspx. To add any formatting, you'll need to use Wikitext.

  •  

 

Checkout

The custom message for Checkout will let you add a custom message to the Payment section of the Checkout iframe. This is only available if you are using Classic Checkout (Checkout.aspx).

If you need to supply your Web Developer with guidance, take a look at the details about the Checkout iframe on our Integration Portal.

Enter your custom message into the box marked Custom message for checkout.aspx. To add any formatting, you'll need to use Wikitext.

REMINDER: This custom message only works if you are using Classic Checkout.

 

Merchandise

The custom message for Merchandise lets you add a custom message to the Merchandise iframe (Merchandise.aspx). This message will appear before the itemised list of Merchandise.

Enter your custom message into the box marked Custom message about merchandise. To add any formatting, you'll need to use Wikitext.

 

Unexpected error

If a Customer experiences an unexpected error, they will reach the Error iframe (Error.aspx). 

By default, all systems are pre-populated with the message: An error has occurred. No more details are available for this error.

You may wish to customise this message to provide more information, such as your Box Office contact number or email address. 

WARNING: If you remove this custom message, an empty iframe will display. Having a blank page would create a confusing experience for the Customer, therefore, we always recommend having an Unexpected Error message.

Enter your custom message into the box marked Custom message to display when there is an unexpected error online. To add any formatting, you'll need to use Wikitext. For guidance for Web Developers, take a look at our Integration Portal.

 

Fixed Series error

If a Customer is in the process of purchasing a Fixed Series and an error occurs, they will reach the Fixed Series error iframe.

By default, all systems are pre-populated with the message: An error has occurred. No more details are available for this error.

WARNING: If you remove this custom message, an empty iframe will display. Having a blank page would create a confusing experience for the customer, therefore, we always having an Unexpected Error message.

Enter your custom message into the box marked Custom message for an Error Encountered in the Fixed Series Purchase Path. To add any formatting, you'll need to use Wikitext. For guidance for Web Developers, take a look at our Integration Portal.

 

Choose Seats

The custom message for Choose Seats will let you add a custom message to the top of the Choose Seats iframe (ChooseSeats.aspx).

Enter your custom message into the box marked Custom heading for chooseseats.aspx. To add any formatting, you'll need to use Wikitext.

 

Transaction Commissions

The custom message for Transaction Commissions will let you add a custom message to the bottom of the Prices section of the Choose Seats iframe. 

Enter your custom message into the box marked Transaction Commission messaging during customer ticket selection. To add any formatting, you'll need to use Wikitext.  

This message won’t appear on your system by default. If this is something that is impacting you then Contact Support.

  • Use the placeholder {0} to have this populate with the transaction commission value set in your system.

 

Off-sale Events

If a Customer reaches the Choose Seats iframe (ChooseSeats.aspx) of an Instance which is marked as On Sale but has a Sell Until Date which is in the past, you can display a custom message. 

If this custom message is left blank, there is no default message. The Seating Plan will not display if the Instance Sell Until Date is in the past.

You can add a custom message here to personalise it to your organisation, for example, by adding a phone number to call your Box Office.

Enter your custom message into the box marked Custom message to display for off-sale events. To add any formatting, you'll need to use Wikitext.  

 

 

Gift Vouchers

You can add a custom message which will appear at the top of the Gift Voucher iframe (GiftVouchers.aspx). 

Gift Memberships also appear in this iframe, so you may want to ensure your messaging is relevant to both Gift Vouchers and Gift Memberships.

Enter your custom message into the box marked Custom message to display when a Gift Voucher is added to the basket. To add any formatting, you'll need to use Wikitext.  

 

Gift Voucher code not found

When a Customer tries to redeem a Gift Voucher, you can add a custom message which will display when the Gift Voucher code entered is incorrect. This will appear in the Order Summary section of the Checkout iframe.

By default, the message will say: There was 1 error found in the information submitted: Unable to redeem gift voucher.

If you choose to add a custom message, this will display as well as the default message.

Enter your custom message into the box marked Custom message to display when a Gift Voucher code is not found. To add any formatting, you'll need to use Wikitext.  

 

Additional Details

When a Customer reaches the Additional Details tab, during Checkout you can add a custom message which will appear above any additional questions such as Order Attributes.

Enter your custom message into the box marked Custom message for the Additional Details tab on checkout.aspx. To add any formatting, you'll need to use Wikitext.  

 

Supplementary Events

The Supplementary Events iframe (SupplementaryEventsPage.aspx) appears:

or

Before the Basket/Cart iframe if you have linked a Supplementary Event to the chosen instance.

Enter your custom message into the box marked Custom message to display when showing supplementary events. To add any formatting, you'll need to use Wikitext.  

TIP: You can add more detail to the Supplementary Events page by adding Website Content for each Event with Wikitext during the set up of Supplementary Events.

Edit Tickets

When a customer reaches the Edit Tickets iframe (EditTickets.aspx) during the purchase path, you can add a custom message which will appear above the Ticket information.

Enter your custom message into the box marked Custom message for edittickets.aspx. To add any formatting, you'll need to use Wikitext.  

 

Contact Preferences - Account creation

You can add a custom message which will display to a Customer creating a new account on the Contact Preferences section of the My Account iframe (MyAccount.aspx).

Enter your custom message into the box marked Custom message for the contact preferences screen during account creation. To add any formatting, you'll need to use Wikitext.  

 

Contact Preference - Account editing

You can add a custom message which will display to a Customer editing their account on the Contact Preferences section of the My Account iframe (MyAccount.aspx).

Enter your custom message into the box marked Custom message for the contact preferences screen during account editing. To add any formatting, you'll need to use Wikitext.  

Partner Companies Contact Preferences

If you use Contact Preferences for Partner Companies, you can add a custom message which will display on the checkout iframe (Checkout.aspx).

Enter your custom message into the box marked Custom message for the partner companies preference screen during checkout. To add any formatting, you'll need to use Wikitext.  

  • TIP: You can also add a web description during the set up of Partner Companies Contact Preferences which will display on this page.

Tags during Account creation

If you have Tags which are available to customers on Web, you can display a custom message which will display on the My Account iframe (MyAccount.aspx) > Other Preferences during account creation or editing.

Enter your custom message into the box marked Custom message for the tags screen during account creation and editing. To add any formatting, you'll need to use Wikitext.  

Donation Recognition

If you capture Donation Recognitions, you can add a custom message to the Donations iframe (Donations.aspx) which will display next to the Donation Recognition Name box. 

You might want to add a message here to let Customers know where their donation will be recognised.

Enter your custom message into the box marked Custom heading for Donation Recognition name box. To add any formatting, you'll need to use Wikitext.  

Anonymous Donations

If you capture Donation Recognitions, you can add a custom message to the Donations iframe (Donations.aspx) which will display next to the Make Donation Anonymous check box. 

By default, this will be blank, so you’ll need to add a custom message here to let the Customer know what the check box does.

Enter your custom message into the box marked Custom message for donation anonymity checkbox. To add any formatting, you'll need to use Wikitext.  

Tribute

If you capture Donation Tributes, you can add a custom message to the Donations iframe (Donations.aspx) which will display next to the Make this Donation a Tribute check box. 

By default, this will be blank, so you’ll need to add a custom message here to let the Customer know what the check box does.

Enter your custom message into the box marked Custom message for tribute capture checkbox. To add any formatting, you'll need to use Wikitext.  

Basket/Cart name of Order owner

This custom message will appear on the Basket/Cart iframe (Basket2.aspx) to show the name of the Order owner. The Order owner name is the name of the logged in Customer or the name selected in the Choose Attendee iframe for facilitated bookings.  This message will appear above the Savings panel.

REMINDER: The name of the Order owner will only show if the customer is logged in.

Enter your custom message into the box marked This will appear on Basket2.aspx to indicate who the order is for. To add any formatting, you'll need to use Wikitext. 

  • Use the placeholder {0} to have this populate with the name of the Customer.

Choose Attendee

The Choose Attendee iframe will appear in the purchase path if you are using Facilitated Booking. You can add a custom message to this page below the Choose Attendee header and above the selection.

Enter your custom message into the box marked Custom message for the Choose Attendee iframe. To add any formatting, you'll need to use Wikitext.  

Ticket Subscriptions

If you use Ticket Subscriptions, you can add a custom message to the Ticket Subscriptions iframe (TicketSubscriptions).

If you also choose to add a header, this message will display below the custom message for the Ticket Subscriptions header.

Enter your custom message into the box marked Custom message for the Ticket Subscription iframe. To add any formatting, you'll need to use Wikitext.  

Ticket Subscriptions header

You can add a custom header to the Tickets Subscriptions iframe (TicketSubscriptions). By default, this iframe will show Ticekt Subscriptions, but you can overwrite this with this custom header of your choice.

This header will appear above the custom message for Ticket Subscriptions iframe.

Enter your custom message into the box marked Custom message for the Ticket Subscription Header. To add any formatting, you'll need to use Wikitext.  

 

Settings Interface - Donations on Web

The Donations on Web section can be found within the Settings Interface, alongside Custom Website Messages:

 

 

Donations

You can use the custom message for Donations to add a custom message to the Donations iframe (Donations.aspx). This message will also show when the Donations section appears during Classic Checkout (Checkout.aspx).

Enter your custom message into the box marked Custom message for donations.aspx. To add any formatting, you'll need to use Wikitext.  

Donation in Checkout

You can use the custom message for Donations in checkout to add a custom header and message to the the Donations section during Express Checkout (Checkout.aspx).

To add a header, enter your custom message into the box marked Custom message for the donations step in the new checkout flow. This header does not use Wikitext.

To add a message, enter your message into the box marked Custom body wikitext for the donations step in the new checkout flow. You can use Wikitext to format this message. 

 

Gift Aid declarations

You can use the custom message for online Gift Aid declarations to add a custom message to the Checkout iframe (Checkout.aspx). This message will appear under the Gift Aid section which appears when a customer adds a Donation to the Basket.

Enter your custom message into the box marked Custom message for online Gift Aid declarations. To add any formatting, you'll need to use Wikitext

If the Customer clicks the button More info about Gift Aid, they will see the standard message from HMRC.

 

Settings Interface - Memberships on Web

The Memberships on Web section can be found within the Settings Interface, alongside Custom Website Messages: 

Custom message for Memberships

You can use the custom message for Memberships to add a custom message to the Memberships iframe (Memberships.aspx). 

Enter your custom message into the box marked Custom message for memberships.aspx. To add any formatting, you'll need to use Wikitext



Settings Interface - Offers on Web

The Offers on Web section can be found within the Settings Interface, alongside Custom Website Messages: 

Offers on Web

Although you are given the option to edit custom messages related to Offers here, these settings are not currently in use and will be removed in a future release.

REMINDER: Custom Website Messages, related to Offers under the Settings Interface > Offers on Web tab are not currently in use and will be removed in a future release.

 

Further Reading

To continue learning about how to configure iframes, take a look at the following articles: