Account & Cloud

The Account & Cloud settings allows you to manage third-party account connections, cloud synchronization, backups, your personal domain, and more.

Accessing Settings

To open the Account & Integration and Personal Cloud settings, click the Settings gear in the bottom-left of the default view when opening the Pieces Desktop App.

Then, navigate to either of the two sections:

Account & Integrations: Manage external account connections and sign into or out of your Pieces account.
Personal Cloud: Connect to or disconnect from your Personal Cloud, manage backups, and edit the URL of your personal domain.

Account Management

External account connections in Pieces are managed through third-party services such as Microsoft, Google, or GitHub.

Viewing & Editing Linked Accounts

You can connect or disconnect third-party services from this modal.

View connected accounts (GitHub, Google, Microsoft).
Accounts are linked upon sign-in and cannot be manually edited.
Profile information (name, email, avatar) is pulled from the linked service.

Personal Cloud

Pieces can run entirely offline, but connecting to Pieces Cloud enables real-time syncing and access across devices.

Cloud Syncing

Cloud syncing is optional.

Once connected, syncing is automatic and happens in real time. Once connected, the only way to disable syncing is by disconnecting from Pieces Cloud.

Any material saved in Pieces Drive or marked as a snippet is backed up. There are no storage limits on cloud-synced data.

Disconnecting Personal Cloud

You can disconnect from your Personal Cloud at anytime by clicking the slashed Cloud icon, which opens up a Disconnect Cloud modal.

There are several features which require connectivity to your Personal Cloud, so be sure to read through these before disconnecting:

Link Sharing: The ability to generate and share links for saved materials from the Pieces Drive.
Cloud ML: Cloud-based enrichment of metadata for saved materials.
Cloud Backup: The automatic synchronization of your data to Pieces Cloud.
Cloud Integrations: Your Pieces Cloud which controls your personal subdomain and other integrations.

Backup & Restore

Pieces allows manual backups of your data for long-term storage and recovery.

These data backups are not automatic and must be manually created—to do so, open the Backup Manager modal by clicking Backup & Restore Data.

Clicking Create Backup saves a snapshot and uploads it to Pieces Cloud.

Backup Contents

A Pieces backup contains the following data:

Data Type	Summary
Snippets	All saved code snippets and related metadata.
Pieces Drive Files	Any files stored in Pieces Drive.
User Preferences	Theme, UI settings, and personalization options.
Pieces Copilot Data	Recent chat history and AI context for Pieces Copilot.
Search & Tagging Data	User-defined tags and previous searches for quick retrieval.
Account Connections	Linked GitHub, Google, or Microsoft accounts (without passwords).

Backups do not include Pieces Cloud data that is already synced or external files which are not explicitly stored in Pieces Drive.

Restoring a Backup

Previous backups are listed in the Backup Manager with details including:

Timestamp of when the backup was created.
File size of the backup.
Device name that created the backup.
PiecesOS version at the time of backup.

Clicking the Restore icon will recover all saved materials, settings, and preferences and return Pieces Drive and the Pieces Desktop App to that previous state.

Deleting a Backup

To delete a backup, click the Trash icon. Note that, when a backup is deleted, it cannot be restored. This is a permanent deletion.

Personal Domain

When connected to Pieces Cloud, each user receives a personal subdomain for sharing snippets.

These domains are not directly accessible, but rather prepend the URLs that are generated when sharing saved materials.

Custom Subdomain

The assigned subdomain (yourname.pieces.cloud) is used when sharing snippets.

There is no profile page associated with the domain.

Changing the Subdomain

You can change the subdomain (i.e., your name) if you like.

To do so, navigate to Personal Cloud inside of the Settings view and edit the text input field under Personal Domain.