Documentation & Help

How can we help you?

Help
 Print
Embed the Soundslice player
You can embed Soundslice scores in your Xen courses using the Text component and inserting an iframe with the URL provided by Soundslice.

The embed version of the player is nearly identical to the player you’ll find natively on soundslice.com. The main difference is the color scheme, which is intentionally neutral so that it fits with any site.

Every Soundslice account can embed one slice for free. To embed more, you will need to upgrade to the Licensing plan.

How to embed a slice

To embed one of your slices, you’ll need to mark it as embeddable. By default, each slice you create is not marked as embeddable.

How to mark a slice as embeddable

1. Edit the slice.

2. Click the share button in the upper right, next to the Save button. By default, this will say “Private”:

3. When you click it, choose the “Embed this slice…” option:


4. You’ll see the “Embed this slice” menu pop up. Change the setting from “Disabled” to “Enabled”:


5. You’ll see the slice’s unique embed code. Click the “Copy” button to copy this to your clipboard.

6. Click “Save” and your slice will be marked for embedding.

Allowing your Xen domain

In order to embed one of your slices in a website, you need to add your Xen Domain to your allowlist.

Allowlists are a security measure at Soundslice level, to prevent your slices from being embedded anywhere - so noone can stealing your content (and possibly costing you some charges in Soundslice fees).

To edit your allowlist:

1. Go to the Edit embed allowlist page, accessible via your account settings.

2. Enter the domain(s) your website uses, one per line. Examples of domains are:

  • learn.example.com
  • apps.learn.example.com

Note these do not include http:// or https:// nor any slashes. It’s only the domain.

Also note that www.example.com and example.com are treated as two separate domains. Make sure to include both, if appropriate.

As soon as you save your allowlist, the changes take effect immediately.

What happens if my slice is embedded on a domain that’s not on the allowlist?

The slice won’t display. The user will see an error message saying the current domain isn’t on your allowlist. You will not get charged for this user/view.

Using the embed code

Once you have your slice’s embed code, paste that into your course via the text editor.

How to insert the embed code

  1. Select a text block, or insert a new one.
  2. Click on "Edit"
  3. Select the Code option in the toolbar "</>"
  4. In the new window, paste the code from Soundslice,
  5. Click "Save". 
Your player is now visible.


Was this article helpful?