How to create and use an Appointments scheduler widget

Appointments scheduler widgets allow you to embed a button that users can click to schedule an appointment with you, which can be especially handy in your LibGuides profile boxes! When a user clicks on the customizable button, a window will pop up allowing them to view your available appointment times and book an appointment.


Creating an Appointments widget

  1. Click on Appointments in the orange command bar.
  2. Click on the Widget/Embed Code tab.
  3. Under the Embed the My Scheduler Widget in external websites panel, use the Users to Show option to select which users to show in the widget. This limits who can be booked via this widget.
    • Only Myself: limits patrons to only seeing your personal availability times, but across all of your locations. (If you belong to multiple locations, users will first see a location selection page.)
    • Only Myself, but at a particular location/group: similar to Only Myself, but patrons will only see your availability at the location and group you select.
    • All users with Appointments enabled: this allows someone to book appointments with any available librarian. (If multiple locations are set up, users will first see a location selection page.)
    • All users with Appointments enabled at a particular location/group: similar to All users with appointments enabled, but patrons will only see availability times at the location and group you select.
  4. If you chose the option to display availability at a particular location/group, use the Location and Group dropdowns to select which location and group to display.
    • If you selected Only myself or All users with Appointments enabled, the Location and Group‚Äč dropdowns will not appear.
  5. Set the Page Title, which appears at the top of the pop-up window.
  6. Use the Width of popup window field to set the width of the window in pixels.
  7. Use the Height of popup window field to set the height of the window in pixels.
  8. In the Button Text field, enter the label you'd like to appear on the button. This is what users will click to launch the widget's pop-up window.
  9. Use the Button Text Color field to set the font color of the button text. If you know the exact hex code value for the color, you can type it in. Otherwise, click in the field to use the built-in color picker.
  10. Use the Button Color field to set the background color of the button. If you know the exact hex code value for the color, you can type it in. Otherwise, click in the field to use the built-in color picker.
  11. Use the Button Border Color to set the border color of the button. If you know the exact hex code value for the color, you can type it in. Otherwise, click in the field to use the built-in color picker.
  12. If (and only if) you will be embedding this widget in a page that does not already include jQuery, enable the Include jQuery Library checkbox.
    DO NOT include jQuery if you will be embedding this inside of LibGuides or any other Springy product. jQuery is already loaded in all of our apps, so including it a second time will cause jQuery-powered elements (such as page menus) to stop working.
  13. As you make changes to the widget settings, a working preview widget will appear -- feel free to give it a try!
  14. Click inside the Embed Code text box to highlight it. Then, copy the code by either:
    • Pressing CTRL + C on your keyboard
    • Right-clicking on it and selecting "Copy"

Example of creating an Appointments widget 


Booking appointments via a widget

  1. Click on the widget's button to launch the My Scheduler window.
  2. If your admin has enabled Appointment Categories, select the category of appointment you want to schedule.
  3. Select an appointment date from the calendar.
  4. Select an appointment time on that date.
  5. Complete the booking form.
  6. Click the Confirm Appointment button.

Screenshot highlighting a My Scheduler widget's button

Example of selecting an appointment date and time

Example of submitting a booking

Related Articles