Foundry modules / Documentation
Where the Foundry phone keeps your data
Last checked 2026-10-08
The short version
Everything the phone stores stays in your Foundry world and your Foundry data folder. The phone makes no network requests of its own, and nothing is sent to ShawnsVTTs. It needs no account for your players, and no database or file service from us. Your install link is only used to download the module.
Where each kind of data lives
| What | Where it is stored | Who can change it |
|---|---|---|
| Texts, email, group chats and the party feed | In the sender's character data, inside the world | The character's owner, and the GM |
| Notes, the call log, wallet history and read marks | In the character data of whoever wrote them | The owner, and the GM |
| Handset state, phone numbers, signal zones, notices, the calendar, battery settings, NPC contacts and voicemail greetings | World settings | The GM only |
| Money | On the character sheet, in your game system's own currency | Moved by a connected GM when a payment is made |
| Calls ringing, and requests to the GM such as a payment or a charge | Nowhere. They travel over Foundry's live connection and are applied by a GM's client | Not applicable |
| Images and audio files the GM attaches or adds | Files in your Foundry data folder, in a folder named shawnsvtts-phone-uploads, or wherever the link you gave points | The GM, who uploads them |
| A player's wallpaper | Resized and stored inside their character data, not as a file | The player |
Players do not need upload permission
Players never upload files through the phone. The GM attaches images and audio, and GMs can always upload in Foundry. A player sends a photo from their own gallery, which holds pictures the GM placed there. A player's wallpaper is resized in the browser and stored in their character data. You do not need to give players Foundry's file upload permission for any of this.
Privacy is a friendly-table arrangement
Foundry sends every character's data to every connected player's browser. So the phone hides other people's texts, notes and photos in the interface rather than behind a lock. A player who knows how to open their browser's developer tools could read data that was not meant for them, and could read (though not change) the GM's world settings. Most tables are fine with that. If yours is not, keep real secrets out of phone messages and tell your players that the phone is not a safe.
Two things to know. Unsend blanks a text for everyone, but the copy the optional chat echo wrote into the Foundry chat log stays, and an uploaded file stays on disk. See Unsend a text message and Echo phone messages to chat.
Backups and moving a world
Texts and settings are part of the world, so a world backup or export carries them. Uploaded files live in the Foundry data folder, so back up your data folder, and copy the shawnsvtts-phone-uploads folder along with the world if you move it to another server. Links that point at files elsewhere keep working only while those files exist.
Long campaigns
Messages, notes and wallet history are kept for the life of the world, and there is no rolling window yet. In a long campaign with a chatty table the character data grows, and Foundry loads it for everyone when the world starts. The GM can tidy superseded read marks and similar entries by running game.modules.get('shawnsvtts-phone').api.compact() in a script macro. See Macros and the phone API.
Offline and fonts
The phone works wherever Foundry works, including tables with no internet connection. Its fonts are bundled with the module.
Related
Foundry Virtual Tabletop belongs to Foundry Gaming LLC. ShawnsVTTs modules are independent add-ons and are not made, endorsed or supported by Foundry Gaming LLC.