Request form on your website

The embed widget - a request form you place on your own website, so residents and occupants can report issues with no account and no login.

The embed widget puts an AssetLab request form directly on your own website - a town's "report an issue" page, a property manager's tenant site, an intranet. Visitors fill in a short form and it becomes a work request in your organization: no account, no login, no AssetLab branding required. It is built for the public you serve - residents, occupants, visitors - the audience one step wider than the email-only reporters email intake covers.

How it works

The widget is a small snippet you paste into your site:

<a href="https://app.assetlab.ca/embed/request/?key=emb_..." data-assetlab-request>Report an issue</a>
<script src="https://app.assetlab.ca/embed.js" data-key="emb_..." async></script>
<p data-assetlab-credit>Powered by <a href="https://assetlab.ca" rel="nofollow">AssetLab</a></p>

The form appears where the link is, and the link is hidden once the form has loaded. The link is the fallback: visitors see it, and it opens the same form on a page of its own, whenever the form cannot load - a content editor stripped the script, scripts are turned off, or the page's address is not on the embed's allowed websites. In popup mode the link is what opens the dialog, so it stays visible; change its text to suit your page. The last line is the "Powered by AssetLab" credit, which every widget carries. If you remove it from your page, the form shows the credit itself. Older snippets, a single script line, keep working unchanged.

The form renders where the snippet sits, sized to fit, in your colors. It looks like the requester portal's request form: where it is, the visitor's details, and what's wrong, side by side when there is room and stacked when there is not, with rooms picked from a searchable list. When a visitor submits:

Form fieldBecomes
Name and emailThe requester on the request
TitleRequest title
DetailsRequest description
Site, building, room or area, category, urgencyThe request's associations and priority (each field optional, and only shown if you enable it)
PhotoAn attachment on the request

The submitter is matched against your existing requesters by email address; an unknown submitter gets a new requester record. The request lands in Work Requests as Pending Review, exactly like a portal or email submission, and your normal flow takes over: triage, conversations, approval or decline. The submitter gets a confirmation email immediately, and each staff reply in the request conversation is emailed to them - that is how you keep them in the loop.

Setting it up

Administrators manage embeds under Settings → Embed Widget:

  1. Create an embed and name it for where it will live ("Town website", "Tenant portal").
  2. Add your website's address under Allowed websites (e.g. https://www.yourtown.ca). This is required - browsers refuse to display the widget anywhere that is not on this list.
  3. Copy the snippet and paste it into your site where the form should appear. Each embed also shows a direct link to the form on a page of its own, for sharing in an email, a newsletter or on a poster - it needs no allowed website.
  4. Shape the form. Toggle which fields visitors see - site, building and location, category, priority, photo - and set the defaults applied when a field is hidden or left blank. Where there is only one choice - a single site, a site with one building, a building with one location - the form fills it in for the visitor. Categories feed auto-assignment once a request is approved.
  5. Match your site. Set the button, background, and text colors, corner rounding, and light/dark appearance (or let it follow the visitor's system setting). Your organization logo appears automatically if one is set. A live preview shows the result as you adjust it.

Location QR codes

Every location QR code can open one of your embeds for people without an account. Under Settings → Requester Portal → Location QR codes, choose the embed as where visitors without an account go. A visitor who scans the label in a locker room, washroom or lobby then gets the form on their phone with that location already filled in, shown as the location, building and site instead of the pickers. They add what is wrong and a photo, and the request arrives with the location set. The labels you have already printed work as they are.

The embed needs no allowed website for this, because the form opens on a page of its own. A location outside the embed's allowed sites, or a disabled embed, sends the scan to the sign-in page instead. Staff and requesters who are signed in keep their usual scan behaviour.

Each embed has an on/off toggle - turning it off blanks the widget everywhere instantly and is reversible. Deleting an embed never touches the requests it created.

Display modes

The default snippet renders the form inline. Two attributes on the script line change that:

SnippetBehavior
data-mode="popup"Clicking the snippet's link opens the form in a dialog. Add data-target=".report-button" to use your own buttons instead
data-mode="float" data-label="Report an issue"A floating button sits at the bottom-right corner of every page carrying the snippet. Remove the snippet's link line if you do not also want it shown in the page

If your site's content editor strips scripts, an <iframe> pointing at the widget address works as a fallback - the snippet is still the better experience because it auto-sizes the form.

Privacy

The form shows a collection notice above the submit button explaining that the submitted information is used to review and complete the request. You can replace the standard wording with your own - municipal organizations typically point at their own privacy policy - in the embed's settings.

Limits

Good practices