This article offers a summary of what object types are with links to find out more about each individual object type. You can also watch the following Video for a quick overview of objects and a walkthrough of the Object Picker:
Objects are the images that appear inside of your Space, on top of your Space's background image. They can be uploaded as custom object images, or selected from the large variety of pre-generated objects inside of our Object Picker. Objects can be almost any size, but are often scaled to match your avatar's size and can be moved, edited, and deleted without affecting the main background image. There are 2 primary categories of objects:
Decorative Objects - Purely aesthetic with no interaction (Does not count towards Object Limit)
Interactive Objects - Can be activated when your avatar is near the object
Only Interactive Objects are counted towards your object limit when selecting the Town or City plans for upgraded Space Reservations. Non-interactable objects such as chairs, tables, and other custom uploaded objects that are purely decorative will not count toward your limit.
It is possible to turn a chair, table, or other traditionally Decorative Object into an Interactive Object. Once an interactive effect is placed on an object, it becomes an Interactive Object, regardless of what the image originally was.
Interactive Objects
Interactive Objects are further broken down into 2 categories:
Basic Interactive Objects - View images or text uploaded to Gather
Advanced Interactive Objects - View or open a link external to Gather + Spotlight Tiles
The Town price allows 10 Basic Interactive Objects and 3 Advanced Interactive Objects, whereas the City plan allows 50 Basic Interactive Objects and 10 Advanced Interactive Objects. There is no limit on Interactive Objects on either the Free or Metropolis plans.
Basic Interactive Objects
Embedded Image - Upload an image (.png, .jpeg, .gif) to display inside a Gather iframe.
Note Object - Display typed text or provide text links for users to open in a new window.
External Call / Zoom Call Integration - link to an external call (Zoom, Webex, Teams, etc.). Call will open in new window and auto-mute your Gather browser tab.
Embedded Video - link to any embeddable video or live stream to display inside a Gather iframe.
Advanced Interactive Objects
Synchronized Embedded Video - link to any embeddable video or live stream to display inside a Gather iframe.
Embedded Website - link to any embeddable website to display inside a Gather iframe.
Spotlight Tiles - Allows the user standing on this tile type to broadcast their video and audio to everyone in the Room
All categories are listed on the left hand menu of the object picker. There's also a search bar at the top if you're looking for a specific object. Our design team adds new objects weekly so make sure to be on the lookout for those!
Object Picker Default View
On the bottom left, there are two special options:
- Insert Text feature allows you to use plain black text to label your space. You can change the size of the text and set the x,y offset. At this time, you cannot change the font or color.
- Upload New allows you to upload any sort of custom object! Here's a short video on how to make use of this - https://youtu.be/2XjTLK6aNz0
Object Interaction Types
- Embedded Website: link to any embeddable website directly inside a Gather frame.
- Embedded Image: upload image (.png, .jpeg, .gif) to display inside a Gather frame.
- Embedded Video: link to an embeddable video from YouTube, Twitch, or Vimeo. Works for playlists and live streams as well.
- External Call: link to an external call (Zoom, Webex, Teams, etc.). Call will open in new window and auto-mute in Gather.
- Note Object: display lines of text or provide links for users to open in a new window.
You can control how close a user must be to interact with an object, which is called the Activation distance. From the Object Picker, in the Object Interactions section, enter the maximum number of tiles a user can be from an object to interact with it. This distance includes all diagonals and is measured starting from the outermost edge of the tile(s) the object is contained within.
You can set the Activation distance for any object in the Object Interactions section of the Object Picker.
If you do not set an activation distance for an interactive object, it will default to 3. If set to 1, the user can only interact with the object when they are in the tiles directly next to the object. If set to 0, the user must stand directly on top of the object to interact with it.
This document takes up 1 tile and has a default Activation distance of 3, which means anyone standing within 3 tiles of the object in any direction will be able to interact with it .
This piano has a 2x3 tile size and an activation distance of 3. The Activation distance begins at the edge of all of the tiles the object exists within.
Embedded Websites
You can link any embeddable website inside of an object and have it open directly inside of Gather within an iframe. This includes individual Google documents, spreadsheets, and forms, but not Google Drive File Directories. Almost any site can be embedded as long as the website administrator allows embedding.
To embed a website, select a object and click on "embedded website" under the Object Interactions.
An animation showing how to embed a document using the object picker. You can use any object in the object picker to embed a website. This example specifically uses the document object.
Embedded Website Not Working
To make sure the website you want to use can be embedded, you must make sure that:
1.) It is an HTTPS site. Unfortunately, HTTP sites will not work due to security concerns.
2) The website administrator allows embedding. If they do not, you will get a message saying "refused to connect" or something similar. You can test this here: https://www.w3schools.com/tags/tryit.asp?filename=tryhtml_iframe
Note: Some sites might require that you allow 3rd party cookies to display properly.
Not all websites are the correct format to be embedded within Gather, and it is also common practice that companies and website hosts block embedding or their URLs to avoid spam.
A workaround for websites that can not be embedded would be to paste the URL within the object as a note interaction. This will allow the participants to see a URL when they interact with that object, like in the screenshot below. If they click the URL it will open the website in a new tab.
A screenshot of the note interaction selected.
A screenshot of what participants will see when they interact with an object that has a URL pasted as a note interaction.You can embed your own images or posters inside of an object and have it open directly inside of Gather within an iframe.
Here's a video that walks you through embedding images using our poster set templates, otherwise read on for more info!
Embedded Image Objects include a preview of your image that appears when you approach the object and are within its activation range.
An example of the preview seen when you approach an embedded image.
In order to upload and embed an image, the image must be:
- in .png, .jpg, .webp format
- at least 1000px for the width
- at least 600px for the height
- max 3MB in size
We recommend a minimum DPI of 72, but this is not a requirement. All images will be enlarged to fill inside of the iframe, so exact dimensions and proportions are not required. Transparent backgrounds will be filled with a black background.
When you interact with the embedded image, the full image will open inside of an iframe.
This is what it looks like after you interact with an embedded image object with the 3 additional image navigations tools on the right side.
Optional Caption
You have the option of including a caption or short blub when you first create your embedded image object. This will appear when you interact with the image object when you mouse over the information icon on the right side of your image.
An example of the caption appearing when you mouse over the information icon on the right side of your opened image object.
Presenter Mode
After interacting with an embedded image, you and anyone else who has opened the image may use the "Presenter Mode" tool on the right hand side to click and indicate specific areas of the image or poster that you are discussing. Everyone who has the image open will see the locations that you click on while in Presenter Mode. The indication will appear as a small colored circle that will disappear after a few seconds.
Presenter Mode will appear on the right side of an opened image object, below the caption and above the zoom tool.
Additional Information
Here's a great article one university wrote up about their poster upload experience as well - https://photonicsonlinemeetup.org/virtual-poster-session-gather-town/.
If you'd like to show showcase a video or set up a livestream, you can embed video into an interactive object. The following platforms are great options for sharing video:
- YouTube
- Vimeo
- YouTube live (livestreaming)
- Twitch (livestreaming)
- Or really anywhere with HTTPS and a video embed link.
In the Object picker accessed through the Mapmaker, select the TV object you'd like to use. Enter the URL of your video / livestream.
Embedded Video Options
With a tv selected in the Object Picker, in the Object interactions section, click Embedded video. Copy the URL into the Video field. Return to your Space (select the three-line hamburger menu) and test interacting with the tv.
If it doesn't work, try pulling the link to the video out of the code that appears when you click 'share', then 'embed'.
A screen capture of the 'Embed Video' box which appears after you click the share button then the embed button on a YouTube video. The youtube video used as the example is 'lofi hip hop radio - beats to relax / study to'. The preview image is an anime girl wearing headphones and sitting at a desk.
Activation Distance - This is the distance which defines how far away from the embedded video object the user can be before a video preview no longer appears in the lower left corner.
Change Map Image - Changes the image that appears on the map when the object is not interactable. Doesn't have to be a TV, but this is helpful visual shorthand.
Active Image (Highlight) - Changes the image that appears when the object moves into activation range. (By default, this is the yellow highlight).
Synchronized Start Time - Automatically plays the video to everyone within the interaction radius at the specified time.
Object Active Start time - Sets the time when the object appears on the map.
Object Active End Time - Sets the time when the object disappears from the map.
If you choose to use a live stream link, please do not set up a start/sync time. This will mess with the video and will not allow the live stream to play.
More About Syncing Video
Here is a short tutorial on Synced TV Objects
Gather supports "synced" objects, that are set to start playing an embedded video at the same time for everyone. To set a synchronized start time, simply select the time and date you would like your video to automatically start in the appropriate field.
Embeded video options with the Synchronized Start Time field boxed under the advanced options setting.
To test your Synced TV to see if the video plays back properly, set the 'time' for a time ~1 minute in the past, and make sure the video plays accordingly. (It should start ~1 minute in.)
Video objects with a sync time set that have not yet reached their sync time will appear on the map, with a blank black screen. The blank screen will continue to display until the start time you have entered. Guests will not be able to start playing the video on their own.
A black screen with small white text that reads "There's no video playing right now!"
Note that you cannot use the Synchronized Start Time in conjunction with Live Streams.
More about Livestreams
For livestreams you need to leave the "Synchronized Start Time" field blank. Meaning you should not fill out the "synced tv" field. This is because the synced TV function automatically moves the time dial forward or backwards to ensure all participants are seeing the same part of a video and Livestreams on Youtube do not have a time dial. Youtube already handles the video synchronization on their end which means you only need to link the live stream as if you were embedding a regular video.
Advanced Youtube Embedding
If you would like your participants to have finer control over their video player, you can embed the video as a website and use the format: https://www.youtube.com/embed/VIDEO_ID to allow them to adjust their video to their preferred resolution
Where the original link will be: https://www.youtube.com/watch?v=VIDEO_ID (and you take the video ID and add it to the above URL).
If you would like more details, you can read Youtube's embed video documentation as well: https://developers.google.com/youtube/player_parameters
Here's a short video on how to place External Call Integration objects -
This feature currently works for any pre-set meeting link; Zoom, Google Meets, Teams, Webex, etc.
How does the user interact with this object?
- User enters a Gather room that has a press 'x' to enter zoom call button.
- They see this text
Text User sees after clicking 'x' to interact with the external call integration object.
- Click on the zoom link and open the zoom application ins a separate window, Gather will auto-mute the user's video and audio output.
- Enter presentation is hosted on Zoom directly
- They exit the zoom call, and head back to Gather to see this message. They click the green button to enter the Gather space exactly where they last left off.
Button to re=enter Gather space after the external call
Tips and Tricks:
- Make sure to increase the activation distance (found under the advanced options for the external call integration object). This will guarantee that anyone who walks into the entire room/area that you designate for the external presentation will be able to press 'x' to interact. Otherwise, you will have too many people crowded in one small area.
- We also frequently see hosts create larger custom objects rather than using our blank object image, so it is visually obvious to users that there's an object to interact with.
- We also frequently see hosts place multiple instances of the same external call object around the room (or in multiple rooms) so more users can interact easily with the object.
If you choose to rotate zoom links throughout the day, you will need to either:
a) designate someone to enter builder mode in the space, erase the object with the old call link, and place a new one (with a new link) during the period of time between speakers, or
b) create visually different objects or places (eg: signs) in the room where people can walk to to get the next zoom link.
Both of these might be trickier than hosting one big zoom call for the room, depending on what you are comfortable with; by default, the 'zoom call integration' object is invisible, and so it will not appear to either participants or builders visually on the map.
If you expect less than 100 participants, using Gather's spotlight feature (and screenshare for slides) might also be an option, although that 100 is a fairly hard limit.
Message in Note Objects
You can place messages inside of note objects. The messages will appear inside of an iframe and can include links to other sites that will open in a new tab.
When you interact with an open a note object, you will see the message inside of an iframe.
Unfortunately, at this time, the note object does not support carriage returns, but you can insert emojis!
Editing a Message inside Note Objects
If you want to change the message of the note, you have to edit the message in the Note Object in the Mapmaker
In the Mapmaker, you select the note object and change the message
Right Panel: Change message on Note Object
Our team has incorporated several pre-set games in our object picker. These games are set up so that you can join private games within your Gather space, so you can play while also video chatting with friends!
Note: We don't own any of the games in the object picker, but we have worked with their developers to 'genericize' them so they create a unique room specifically for your Space when opened in Gather.
If you would like to embed your own game links into Gather for one-off gaming events, we recommend you create a private game room for the game ahead of time and drop links to those rooms directly into the object as an embeddable website. They'll expire eventually, but that skips any awkward intermediate step for now! Remember that the site that your game link originates from must allow embedment of their site
Existing Game Integrations
You can find out more about the games and how they work on their respective websites below. If you are interested in reaching out to us to develop a possible integration for your website or game, please e-mail hello@gather.town with the term "Game Integration" in your subject line!
Tetris: https://jstris.jezevec10.com
Codenames: https://netgames.io/games/codewords/
Poker: https://lipoker.io/
Set: https://setwithfriends.com/
Skribbl: https://skribbl.io/
Sudoku: https://sudoku.gather.town/
Survive: https://surviv.io
Catan-esque game: https://colonist.io/
Dominion: https://dominion.games
Crosswords: https://downforacross.com/
Fishbowl: https://fishbowl-game.com
One Night Werewolf: https://netgames.io/games/onu-werewolf/
Draw Battle: https://drawbattle.io/
Piano: https://musiclab.chromeexperiments.com/Shared-Piano/#pTf9y7kT6
Witch Dice: https://witchdice.com/simple/gather-RAmKIsRU70jQ0U9itable2
Gather's default collaborative whiteboards are powered by http://tryeraser.com/. Eraser has a great interface for note taking, a canvas for drawing, or both!
You can choose the exact color you want for your pen by entering the color code
Changing the Pen Color
How can I save a copy of my whiteboard to share with others?
- Click the Share button the share the link to your whiteboard
- The best way to generate a hard copy would be to "copy as PNG" by right clicking on the canvas and then pasting it into a file editor or image editor then saving as file. That's obviously a lot of steps – we are working with the Eraser team to try to streamline this and support PDF download.
With the embedded image, you cannot upload a PDF. If you would prefer to have a pdf rather than a png or jpeg displayed, you would need to upload it to a public site (such as Google Drive) and use an embedded website object rather than an embedded image object.
If you upload your PDF to Google Drive, you have to alter the shareable link before you can embed it.
For instance:
Original Link: https://drive.google.com/file/d/1RlIH-FVz0BO_4G6ktrsbCTiBrqbaTEx2/view
Embeddable link: https://drive.google.com/file/d/1RlIH-FVz0BO_4G6ktrsbCTiBrqbaTEx2/preview
You can also host a PDF on your website and embed your PDF as a website URL
In order to share your Powerpoint, you first need to upload it to a site that allows embedding. One place you can upload your ppt is to Google Slides. Once you have your presentation on Google Slides, you can embed it after publishing it to the web: from the Files menu. Makes sure that the bottom of the prompt box says that your presentation is published.
This Google Slides presentation is listed as published at the bottom of the dialogue box.
You’ll get a URL like this: https://docs.google.com/presentation/d/e/2PACX-1vSbaMdqLEgO0CjXPzEahfQm4mJIDhaGjU2waSy6DJz4m1hRXQNOBsRaoR74hYwH8s6atXylVla2ODM8/pub?start=false&loop=false&delayms=3000
Delete everything from the original link that begins with "pub?" and replace it with the word “embed” so it looks like this instead: https://docs.google.com/presentation/d/e/2PACX-1vSbaMdqLEgO0CjXPzEahfQm4mJIDhaGjU2waSy6DJz4m1hRXQNOBsRaoR74hYwH8s6atXylVla2ODM8/embed
Copy that modified link and paste it into the URL field for embedded websites.
You can embed Office 365 documents into Gather using the following process:
1) Go to your OneDrive folder in your web browser. ( https://onedrive.live.com/ )
2) Right-click the file you wish to embed.
3) Click 'Embed'.
4) In the panel that appears on the right, copy the text in the 'Embed' box and paste it into a text editor.
5) Extract the embed link from the IFrame text. What the link will look like is highlighted below (it's everything between the quotes that comes after 'iframe src=').
<iframe src="https://onedrive.live.com/embed?cid=[NUMBERS]&resid=[MORE NUMBERS]%[NUMBERS]&authkey=[NUMBERS AND CHARACTERS]&em=2" width="402" height="346" frameborder="0" scrolling="no"></iframe>
6) Paste that embed link into the 'Website (URL)' field.
You can link any embeddable Google Form or make a poll inside of an object and have it directly inside of Gather within an iframe. Almost any site can be embedded as long as the website administrator allows embedding.
Here are the steps to embed:
1) Make a Google Form (ex. "Test Form") - https://docs.google.com/forms/d/e/1FAIpQLSc8HSBu242_ZAusIsW_ik9oAHeam31Jyq_fKqVC-UGrMJ5L1Q/viewform?usp=sf_link
2) Search for the Document Object in the Object Picker and select it.
Document Object
3) Paste the Google Form Link in the Website URL Text box
Google Form Link in Website URL box
4) Click Select, and place the object where you would like it.
5) In your Gather Space, interact with document and the Google Form will popup.
An example of what a Google Form looks like in Gather
Object Stack is located in the bottom right of your screen inside of the Mapmaker when the grid space is selected
When you are in Mapmaker you can select the grid space using the "select mode" tool in the upper left hand corner. From there you will see the "edit stack" menu on the right hand side. This would act as a stack in real life and you would just click and drag the objects above/below one another in the stack. If you'd like the rug to be on the bottom you would want to make sure the rug is below the table and chair within the stack.
Bulletin Board Object
The Bulletin Board is an object in Gather that you can select using the object picker. This is a good way to display information such as birthdays, holidays, game nights, meetings, lunchtimes, etc.
It's as simple as embedding a Google Document, Miro Board, or any other collaborative application into the Bulletin Board object. If you would like a more formal bulletin board that's not collaborative we recommend using a Google Doc that is not editable.
Bulletin Board Object with Google Doc Website (URL)
Note that you must replace the default Google Doc URL with one that you have created.
Here's an example Gather Bulletin Board for reference:
https://docs.google.com/document/d/1n8wqYfk4qQimlTYuCoVW0897PaXDoGJYO-iV6_KpU2Q/edit?usp=sharing
Google Doc with Bulletin Board Information
Gather has a collection of pre-generated instructional text objects you can use in your space to teach your users how to use Gather.
Using these objects can help your events run more smoothly, and they are formatted and designed to 'fit' Gather's aesthetic.
Screencap of a user in a Gather space, standing next to four lines of instructional text. The user's name is 'FONT IS AMATIC SC'. The text says, in order: "Use arrow keys to move" "These are private spaces" "Press X to interact with Objects" "Walk up to someone to share video"
How to Use Wayfinding Objects
You can use wayfinding objects to point your guests to a specific space or area, to teach them to use Gather, and more!
We would recommend putting these objects near your spawn areas, and making a big enough floor space that users can spawn in, read the text, and walk past it without blocking other users. Here are a few images from our demo conference space:
A screencap of the demo conference, showing the wayfinding objects placed on the floor to direct users.
Wayfinding Objects In the Object Picker
A gif showing the object selection process - you can find instructional text by searching or by using the "wayfinding" category.
To change which text you're putting down on the floor, use the rotate errors to switch between different messages. In order, these messages are:
- Use arrow keys to move
- These are private spaces
- Press X to interact with Objects
- Walk up to someone to share Video
Unfortunately, all of these messages are pre-generated and cannot be changed. To insert your own text, you can either use the "insert text" feature which will insert black text with a transparent background, or you can create your own text in a image editing program and upload it as an image. The font we use is Amatic SC.
Ambient sounds can be added to your space by placing sound objects! Currently, there are two kinds of sound objects that you can find in the object picker:
Sound Emitters: Sound emitters are designed to emit sounds to a large area- they look like speakerphones.
Localized Sound Objects: These objects emit sounds to a small area. The sounds are paired with localized sound objects that look like they would emit the sound in question (Fountains, Fire Pits, Streams, etc.)
Sound Emitters are designed to cover large maps and we highly suggest only placing one; however, if you find that you are not getting enough coverage, you can place several at various intervals.
When deleting Sound Objects, remember to have everyone in the Space refresh their browser for the changes to take effect.
Adjust Ambient Sound Volume
At this time, the sound objects themselves cannot be adjusted. If you find the pre-set volume distracting, you can adjust how they sound to you in your User Settings:
If you don't hear any sounds and you're on a Windows computer, click here to find out how to adjust your Call Settings.
Sound Objects are still in development and we plan to continue exploring the possibilities and adding customization options! If you have thoughts, comments, or questions on these Sound Objects, please feel free to send us an email to Feedback@gather.town with "Sound Object Feedback" in the subject line or post them on our public Q&A board found here: https://feedback.gather.town/ask-a-question.
Before moving to Eraser, Gather used software called Cocreate to power collaborative whiteboards.
Whiteboards created with Cocreate software will not automatically change to Eraser, and their contents will remain available for the foreseeable future.
We intend to remove Cocreate software eventually; we will update this article with a public date once one is available.
Follow our changelog to stay up to date with new Gather features and bug fixes.