Embeds

Get your widget onto your own site.

You have an embed token, and you want your booking, reviews, or lessons widget live on your own website. This page covers what each widget does, the two ways to add one, where the design is set, and what to check when something is not working.

  • Three widgets: booking, reviews, and lessons
  • WordPress plugin, or a plain iframe anywhere else
  • One design, set once in your dashboard
  • Rotate your token to revoke every embed at once

The three embeds

What each embed does

All three are iframes. They load from findaskischool.com in your visitor's browser, so what they show is current and nothing is copied onto your server.

Booking widget

Your lessons with live availability and a checkout, so a visitor can book without leaving your site. This is the only embed that takes payment.

Block
FASS Booking Widget
Shortcode
[fass_booking]

Reviews widget

The reviews left on your Find a Ski School profile, newest first, with your overall rating. Reviews left after a booking made through the platform carry a verified badge; the widget shows what your profile shows, and you cannot edit the feed.

Block
FASS Reviews Widget
Shortcode
[fass_reviews]

Lessons widget

Your lesson catalogue as a list of cards, with prices and images if you want them. Each card links through to the lesson, where booking happens.

Block
FASS Lessons Widget
Shortcode
[fass_lessons]

Before you start

Four things to have ready

Your embed token

Sign in and open your dashboard. Schools find it under Embed Widget → Website embed; instructors find it under My Profile. It begins emb_sch_ or emb_ins_. Your public profile address is not a token and will not work in its place.

A plan that can issue one

Creating a token for the first time needs an active paid plan. A token you already have keeps working, and you can always rotate it — so a lapsed plan cannot stop you revoking one that has leaked.

WordPress 6.2 and PHP 7.4

Only if you are using the plugin — anything older will not run it. If your site is not WordPress, skip this. The iframe route has no requirements at all.

Somewhere private to keep it

Your token is a password, not a profile name. Anyone holding it can put your widget on their own site, so do not post it publicly or paste it into a forum thread.

Installing

Two ways to add one

On WordPress, the plugin is less work and lets you vary the design per site. Everywhere else, paste an iframe. Both end up rendering the same widget.

WordPress: the plugin

The plugin is called Find a Ski School Embeds. It adds three blocks and three shortcodes, and keeps your token in one place instead of in every page.

  1. Ask us for the plugin file, then go to Plugins → Add New → Upload Plugin, upload it, and activate.

  2. Go to Settings → Find a Ski School and paste your embed token.

  3. Press Test connection. When the token is good it answers “Connected”, followed by your own name.

  4. Edit a page and insert the FASS Booking Widget, FASS Reviews Widget, or FASS Lessons Widget block — or paste a shortcode anywhere shortcodes run.

[fass_booking]
[fass_reviews]
[fass_lessons]

The plugin does one other thing this page does not cover: dynamic lesson fields, which place individual lesson values into a design you build yourself in a page builder. The three embeds above need none of that. Read about the plugin

Anywhere else: an iframe

Paste one of these wherever your site builder lets you add raw HTML. If all it offers is a rich-text field, look for an embed, HTML, or custom-code block instead — most builders strip an iframe out of ordinary text.

Booking widget

<iframe
  src="https://findaskischool.com/book/embed/YOUR_EMBED_TOKEN"
  width="100%"
  height="700"
  style="border:none;max-width:100%;"
  allow="payment"
  loading="lazy"
></iframe>

Reviews widget

<iframe
  src="https://findaskischool.com/reviews-widget/embed/YOUR_EMBED_TOKEN"
  width="100%"
  height="700"
  style="border:none;max-width:100%;"
  loading="lazy"
></iframe>

Lessons widget

<iframe
  src="https://findaskischool.com/lessons-widget/embed/YOUR_EMBED_TOKEN"
  width="100%"
  height="700"
  style="border:none;max-width:100%;"
  loading="lazy"
></iframe>
  • Replace YOUR_EMBED_TOKEN with your own token. Everything else can stay as it is.
  • Keep allow="payment" on the booking widget, and only there. The other two take no payment and have no use for it.
  • The heights are a starting point, not a rule. An iframe cannot resize itself to fit its contents, so if your list is cut off, raise the number.

Design

Where the design comes from

Not from the page the widget sits on. An embed cannot read the styles around it, so you set its design in your Find a Ski School dashboard — on the Embed widget tab for a school, or on your profile page if you are an instructor.

What you can change

  • Card design — Classic, Compact, Editorial, or Minimal.
  • Accent colour, used for buttons, links, and price emphasis.
  • Corner radius, anywhere from square to 24 pixels.
  • Colour scheme — automatic, light, or dark.
  • Whether to show images.
  • Whether to show prices. Lesson cards only; the other two ignore it.

Automatic follows each visitor's own device setting rather than your page. An embed sits in its own frame and cannot see the colours around it, and guessing wrong looks worse than following the device.

The sync switch

One switch in the editor, labelled “Use the same design for every embed”. It decides how your design is applied at the moment a widget renders, so flipping it changes every live embed straight away.

Switched on
Your lessons and reviews embeds share one design, and the booking widget takes its accent colour and corner radius from it. This is how a new account starts.
Switched off
Each embed keeps its own design, chosen with the “Which embed to design” picker, and the booking widget goes back to the settings on your Widget tab.

Per-site overrides in the plugin

The plugin can override any of it for one website. Every option starts on “Use my account design”, which means the design you set in your dashboard reaches that site. Change one, and that site stops following your dashboard for that setting until you put it back.

Troubleshooting

When it is not working

Six problems, roughly in the order they turn up. Each one names the cause first, because the fix depends on it.

My widget shows nothing

Cause
Almost always the token. It may be mistyped or half-pasted; it may be the placeholder text from an example, still sitting there unchanged; or you regenerated it, which revokes every embed using the old one the moment you press the button. A lapsed plan does not switch off a token you already hold — but it does stop you getting a new one, so if your plan has lapsed and you have just regenerated, there is nothing to paste back in.
What to do
Copy the token from your dashboard again and paste it fresh; do not retype it. On WordPress, press Test connection — it answers with your own name when the token is good. If you regenerated, update every site and every page that used the old token. If your plan has lapsed, renew it before you regenerate again.

The blocks do not appear in the inserter

Cause
The blocks need a build step that is not part of the plugin source. The file we send you is already built; install from a source checkout instead and the editor files were never built, so the plugin does not register the blocks at all. It puts a warning in your WordPress admin saying exactly that.
What to do
Install the built file we send you. If you are working from source on purpose, run npm install and npm run build in the plugin folder. Either way you are not stuck: the shortcodes work whether the blocks were built or not, so paste [fass_booking], [fass_reviews], or [fass_lessons] into a shortcode block and you get the same widget.

My design changes are not showing

Cause
Two candidates. Either a per-site override is set in the plugin — any option not on “Use my account design” means that site has stopped following your dashboard for that setting. Or the page is being served from a cache, so visitors still get the version rendered before you changed anything.
What to do
Open Settings → Find a Ski School and put every design option you did not mean to change back to “Use my account design”, emptying the accent colour and corner radius fields. Then clear your caching plugin and your CDN, and reload in a private window so your own browser is not showing you its stored copy.

The lessons list is out of date

Cause
The three embeds load live, so a stale list there is a cache on your side. The plugin's lesson fields are different: they keep a copy of your lesson data on your own server and refresh it roughly every 15 minutes, so a price change takes up to about that long to come through.
What to do
Open Settings, Find a Ski School in WordPress and press Refresh lesson data. That page also shows when the data was last checked, and the error if the last check failed. If your page is still wrong afterwards, clear your caching plugin and your CDN, since those sit in front of everything else and will happily serve yesterday's page. Check the lesson is published on your Find a Ski School profile too: an embed cannot show what your profile does not.

I changed my design and only one embed changed

Cause
The sync switch is off. With it off, your lessons and reviews embeds each keep their own design, and the editor only changes the one selected in the “Which embed to design” picker. The booking widget is separate again as well, taking its accent colour and corner radius from your Widget tab.
What to do
Open the Embed design card in your dashboard — on the Embed widget tab for a school, or on your profile page if you are an instructor — and turn on “Use the same design for every embed”; all three then fall in line. If you want them to differ on purpose, leave it off and move the picker to the other embed to design that one too.

Not all of my lessons show

Cause
That is the cap rather than a fault. The lessons embed shows 12; lesson fields in a page builder read up to 50.
What to do
If your catalogue runs past the cap, link to your full Find a Ski School profile from the same page. The embed then carries your headline lessons and the profile carries the rest.

Limits

Worth knowing before you build around it

  • The lessons embed shows 12 lessons. Lesson fields in a page builder read up to 50. Either way there is no second page to request, though Bricks can page through the 50 it receives.

  • With the plugin's lesson fields, data is cached on your server for about 15 minutes. If we are unreachable, your page keeps showing the last good copy for up to seven days instead of going blank.

  • The plugin adds no front-end JavaScript to your site; everything it renders is built on your server. The embeds themselves are iframes, which load in the browser as any embedded content does.

  • One token per WordPress site. To show two different schools, run two sites.

Still stuck

See it before you paste it

The live preview lets you try a widget at three screen widths and copy the code out, without touching your own site. If your problem is not on this page, the Help Centre is the next stop.

No booking fees for skiers and learners, ever.