Embed Rekwest on Your Website

Documentation

Advanced

Already have a website? Embedding brings your song requests straight to it. Add a request box directly onto one of your pages, or place a button that opens the full Rekwest experience. Either way, your visitors go from your site to requesting a song in seconds.

Perfect for DJs, bands, venues, and event companies who want their own website to be the place where guests discover and request music. Both options are free.

Two Ways to Embed

When you set up your embed, you choose between two options. You can switch between them at any time.

Minimal

An embedded request box that lives right on your page. Visitors search for a song and send their request without ever leaving your website. Inside the box, guests can:

Create song requests – search for a song and send the request
Add messages – leave a note with their request, available on Pro

The box stays deliberately focused on that one job, which is what keeps it small enough to sit comfortably on any page.

Note

Unless you are on the Rekwest Enterprise plan, the request box has to live on a page of your website that is publicly accessible on the internet, so not behind a login, a password, or a members only area. The “Powered by Rekwest” attribution that comes with the snippet is required as well and has to stay visible.

Full

A button that opens the complete Rekwest experience in a new tab. Guests get everything the request box offers, plus:

Add tips – tip you along with their request
See and vote on requests from others – so the songs the crowd wants rise to the top
Provide a nickname – so you know who asked for what

If you would rather style the button yourself, you can copy just the plain link instead.

Where Guests End Up

When someone opens your embed, Rekwest sends them to the right place automatically:

One active event – they can request a song in that event right away
Several active events – they see a list of your active events and pick which one to request a song in
One upcoming event, nothing live yet – they can request a song in that upcoming event
Several upcoming events, nothing live yet – they see a list of your upcoming events and pick which one to request a song in
Nothing live right now – they see a friendly “no live events” message

This means you only ever have to paste the snippet once. It keeps pointing at whatever you have running, event after event.

Setting Up Your Embed

Open your Settings
Tap Embed Rekwest on your site!
Choose Minimal or Full
Style it in step 1, watching the live preview update as you go
Copy the snippet in step 2 and paste it into your website

Changed your mind about the colors? Open the ellipsis (three dots) menu in the top right corner and tap Reset styling. This restores every style option to its defaults, and your snippet stays the same.

Styling Options

Your embed should look like it belongs on your site, not like a widget you bolted on. Both options come with a live preview so you can see exactly what your visitors will see.

Styling the Minimal Box

Options are grouped into three panels:

General – background color, primary color, secondary color, accent color, and selection color
Text – text color on primary, on background, on selection, and on accent
Widget – corner radius, language, and removing the Rekwest branding

The request box speaks English, Spanish, French, German, Dutch, Czech, and Italian, so you can match it to whatever language your website is in.

Styling the Full Button

Button text – the label shown inside the button
Button color – the background color of the button
Corner radius – how rounded the corners are
Font, font size, and font weight – how the label is set
Text color – the color of the label text
Border width and border color – set the width to 0 for no border

Prefer to build the button yourself? Switch to Just a link and copy the bare URL instead.

Your styling choices are saved on the device you set them up on. If you want to match your embed to your in app look as well, see Theming & Whitelabeling.

Adding the Snippet to Your Website

Rekwest generates the snippet for you, filled in with your own ID and your chosen styling. Just tap Copy and paste it in. The examples below are shortened to show you the shape of what you get.

A Minimal snippet looks roughly like this:

<div style="...">
                                             <iframe src="https://rekwest.app/embed/v1/request.html?host=YOUR_ID&..."
                                             title="Request a song with Rekwest"
                                             data-rekwest-embed
                                             style="width:100%;height:480px;border:0;display:block"></iframe>
                                             <p><a href="https://rekwest.app/?ref=embed_min&host=YOUR_ID">Powered by Rekwest</a></p>
                                            </div>
                                            <script>/* resizes the box to fit its content */</script>

Make sure you paste the <script> tag along with the rest. That small piece is what lets the request box grow and shrink to fit its content, so nothing gets cut off as guests search and scroll.

A Full snippet is a single line:

<a href="https://rekwest.app/embedded/YOUR_ID?ref=embed_full" style="...">Request a song!</a>

Where to paste it depends on how your website is built:

WordPress – add a “Custom HTML” block and paste the snippet
Squarespace – add an “Embed” or “Code” block and paste the snippet
Wix – add “Embed Code”, choose “Embed HTML”, and paste the snippet
Other – on a static or custom built site, paste the snippet directly into your HTML. Most website builders also have an “Embed” or “Custom HTML” option you can add it to

Enterprise: Remove Rekwest Branding

On an Enterprise plan, you can switch on Remove Rekwest branding in the Widget panel. This hides the “Powered by Rekwest” link and footer, so the request box on your page looks entirely like your own. Enterprise also lifts the requirement that the box sits on a publicly accessible page, so you are free to place it behind a login or on an internal page.

Turning the Embed Off

Need to take it down for a while? Open the Minimal option and tap Disable embedding entirely. Your website embed stops working and visitors will not be able to request songs through it until you turn it back on, which you can do from the same screen at any time. The snippet on your website can stay exactly where it is.

Need Help?

Getting your first embed onto your site? Visit rekwest.app/support or contact our support team. We are happy to help you get it looking exactly right!

VIP Guests