How to add the ‘Contact us’ Tool

Last updated 03/06/2024

Before adding the ‘Contact us’ tool make sure you have added the initialization script tag.

The ‘Contact us’ tool allows you to add a contact us section to one or more pages on your website:

Users are prompted to authenticate first, before they can submit their message. This allows you to convert your users while they are trying to contact you, and ensures that you only receive real requests from real, validated users. Submissions are sent by email to the app owner.

Follow these steps to add the ‘Contact us’ tool to a page:

Step 1

Find the initialization script you have added to your webpage (see initialization script if you have not added it already)

Step 2

In the initialization script, find the line:

BreadButter.configure({app_id: "[APP_ID]"});

Step 3

Add the following line under BreadButter.configure();

null == window.breadbutterQueue && (window.breadbutterQueue = []), window.injectBreadButter = function (e) { "undefined" != typeof BreadButter && BreadButter.init ? e() : window.breadbutterQueue.push(e) };
injectBreadButter(function () {
    continue_with_position: {
        bottom: '45px',
        right: '20px',
    show_phone: true,
    show_company_name: true,
    custom_image_url: 'URL_HERE',
    locale: {
        "CONTACT_US": {
            "ICON_NOTE": "Connect with a real person",
            "HEADER": "Connect with a real person",
            "TEXT_1": "Let's get started with your contact information",
            "TEXT_2": "We only receive what is needed to get in touch with you",
            "SUB_HEADER": "%FIRST_NAME%, how can we help?",
            "MESSAGE_INPUT": "Let us know how we can help",
            "BUTTON": "Send your message",
            "SUCCESS":  "Thanks for reaching out %FIRST_NAME%. We'll get back to you as soon as possible."

Step 4

The following content can be configured to suit your specific requirements (see screenshot):

  • show_phone: Show the "Phone Number" field on the contact us form.
  • show_company: Show the "Company Name" field on the contact us form.
  • continue_with_position: Used for positioning the 'Contact us' tool. Accepts a bottom property and a right property for the offset from the bottom and right edge of the viewport respectively. Accepts 10, '10px' and '10%' for positioning
  • locale: The screenshot below shows the text locations for the locale values. You can use the %FIRST_NAME% parameter in the SUB_HEADER, BUTTON or SUCCESS fields.
    • Note: Each parameter in the locale file has default text, so you don't need to specify them here if you don't want to.
Step 4

Step 5

The custom_image_url parameter is optional and can be removed if you prefer the default envelope in the blue circle. If you wish to replace that image, include this parameter with a URL of the image you want to use instead.

Step 5

Step 6

You should now see the 'Contact us' tool appear on the specified page.

Step 7

Repeat the above steps for any other pages for which you want to add the 'Contact us' tool. You can also put the code snippet in your site header so it appears on all pages.

Don’t use Bread & Butter? Want to learn more about how Bread & Butter solves the four biggest problems facing marketers today? Book a demo and see how Bread & Butter is helping marketers make the most of their first-party data