Skip to content
  • There are no suggestions because the search field is empty.

👈  Clickable Assets

Make your world more engaging with website links, portals, teleporting, and embedded websites, images, or PDFs.

circleCheckCreate Clickable Assets in Your World

circleCheck

Display Text

circleCheck

Display an Uploaded Image

circleCheckEmbed an External Website

circleCheckEmbed YouTube, Vimeo, or Twitch as an iframe

circleCheckEmbed an External Image, Document, or PDF

 


 

Create Clickable Assets in Your World

Make your world more engaging with website links, portals, teleports, and embedded websites, images, or text.

Every asset in your world can become clickable, making your Topia experience more immersive. Clicking on an asset can display text or an uploaded image; open a website (embed or in a new tab), a video, a web hosted image or pdf; let you portal to another Topia world, or teleport to another location within the same world.

 


 

Display Text

With the flick of your Topi's wrist-arm-like appendage, you can display custom text when an asset is selected.

  1. Make sure Builder Mode builder is active
  2. Click on the asset you would like to add display text to
  3. The Select drawer will open on the right. Click on the Configuration tab, then select Links
  4. On the Links page, select Display Text from the dropdown menu
  5. Enter the Title and Description you would like to display

 


 

Display An Uploaded Image

Indeed, with but a second wrist flick, you are able to display an uploaded image when an asset is selected.

  1. Make sure Builder Mode builder is active
  2. Click on the asset you would like to add an image to
  3. The Select drawer will open on the right. Click on the Configuration tab, then select Links
  4. On the Links page, select Display an Uploaded Image from the dropdown menu
  5. Enter the Image Title and upload the image you want to display

 


 

Embed an External Website

Add one or multiple website links to an asset to increase engagement. Depending on whether the website allows website embeds, you can customize the link to open in an embedded iframe within the world, inside the drawer, or in another browser tab.

To Add a Clickable Link:
  1. Make sure Builder Mode builder is active
  2. Click on the asset you would like to add the embed to
  3. The Select drawer will open on the right. Click on the Configuration tab, then select Links
  4. On the Links page, select Add a website, game, tool, or email from the dropdown menu
  5. Click the plus plus button
  6. Enter the website URL under the Link field
  7. Enter a name in the Title field. If the website allows embedding, the title will appear at the top of the website embed frame.
  8. Choose a Link Behavior option to customize how you want the website to appear (modal vs. drawer). A modal iframe will open the link in the center of the screen, while a drawer will open on the left side.
  9. Click the Add Link button to save this link. Complete the previous steps again if you'd like to add additional links to this asset.
Clickable Asset - Modal iFrame
Modal iFrame
Clickable Asset - Drawer iFrame
Drawer iFrame

💡 Tip: If you get a message that the link refuses to connect, the site you are trying to embed does not allow iframing, and you will need to open the link in a new tab instead.

Check out a few of our favorite external games & embeds here!

 


 

Embed YouTube, Vimeo, or Twitch as an iframe

Once an asset is placed in a world, you can easily make it a clickable object that opens a YouTube, Vimeo, or Twitch video by doing the following:

  1. Make sure Builder Mode builder is active
  2. Click on the asset you would like to add the embed to
  3. The Select drawer will open on the right. Click on the Configuration tab, then select Links
  4. On the Links page, select Add a website, game, tool, or email from the dropdown menu
  5. Click the plus plus button
  6. In the Link field, enter the one of the following urls and modify as described below:

    YouTube:

    https://youtube.com/watch_popup?v=xxxxxxxxx 

    Vimeo:

    https://player.vimeo.com/video/xxxxxxxxx

    Vimeo showcase:

    https://vimeo.com/album/xxxxxxxxx/embed/

    Twitch:

    https://player.twitch.tv/?channel=xxxxxxxxx&parent=topia.io

  7. Replace the “xxxxxxxxx” with the unique code found at the very end of your video’s url or the name of the Twitch stream
  8. Enter a name for the video under Title. This name will appear at the top of the video

Now, when a user in the world clicks on the object, an embedded iframe of the video will appear. If the video is live-streaming, it will be synced for all who are viewing it.

 


 

Embed an External Image, Document, or PDF

PNGs, JPGs, JPEGs, and WEBP, oh yes! Any asset can open a statically hosted image, document, or PDF when clicked. This can be great for creating an interactive scavenger hunt or for displaying info throughout a world. Users who then click an asset with an embedded image can view the file in world.

In order to add an image, document, or PDF, the file must have a unique URL. This can be done by uploading the file to: a personal website, Google Drive, Dropbox, Imgur, AWS S3 Bucket, etc. Add the unique URL just as you would add a link to any website:

  1. Make sure Builder Mode builder is active
  2. Click on the asset you would like add the embed to
  3. The Select drawer will open on the right. Click on the Configuration tab, then select Links
  4. On the Links page, select Add a website, game, tool, or email from the dropdown menu
  5. Click the plus plus button
  6. Enter the website URL under the Link field. The link may need to be modified to ensure that it will embed:

on Google Drive:

    • Ensure share settings are set to Public. Double click on the file or click on Preview to open the file. (Do not use a direct share link, such as the link shown in your browser’s address bar or Google Drive share options.)
    • In the window that opens, click again on More actions in the top right-hand corner (three vertical dots icon) and choose Open in a new window
    • Copy the url that appears in this new window and use this url instead to make the clickable asset show the content in an iframe.
    • In the new window, click again on More actions in the top right-hand corner (three vertical dots icon) and choose Embed item...
    • Copy the url from within the embed script, shown between the ” ” quotation marks

on DropBox:

    • Click Share. Create then copy the link.
    • Remove the "dl=0" at the very end of the link and replace it with "raw=1"

Original URL:

https://www.dropbox.com/s/4............h/example.png?dl=0

Modified URL:

https://www.dropbox.com/s/4............h/example.png?raw=1

on Imgur (images only):

    • Right click on the image and choose Open Image in New Tab.
    • Use the link from the new tab if it ends with ".png", if instead it ends in ".jpeg" or ".jpg", replace it with ".png".