General Settings

The General settings tab allows you to configure basic organization information, contact details, associated domains, SSO integration, and delete your organization. These settings control fundamental aspects of your organization's identity and access.

General settings tab with organization name, contact info, and domains

General settings tab showing organization name, contact info, domains, and danger zone

How to Get to General Settings

Go to [portal.pieces.app](https://portal.pieces.app) and sign in. Select your organization from the *sidebar* dropdown if needed. Click `Settings` in the *sidebar* navigation. Click the `General` tab at the top. It's the default tab when you open Settings.

Configuring Organization Details

Update basic organization information, domains, and integration settings.

Updating Organization Information

Modify your organization's basic details including name, contact information, and address.

In the *Organization Name* field, update your organization's name as needed. Update the following contact fields: * **Name** — Name of the primary contact person * **Email** — Primary email address for the organization * **Phone** — Contact phone number Fill in or modify the organization address fields: * **Country** — Select from the *dropdown* * **Street address** — Enter street address * **City** — Enter city name * **State** — Select state from *dropdown* * **ZIP Code** — Enter ZIP/postal code A save reminder appears at the bottom of the page. Click `Save` to apply your changes.

Configuring Associated Domains

Set up domains that are associated with your organization for automatic user assignment.

In the *Associated Domains* section, enter a domain name (e.g., `example.com`) in the *input* field. Click the `+` button next to the *domain* field to add additional domains. You can add multiple domains to your organization. A save reminder appears at the bottom of the page. Click `Save` to save your domain configuration.

Setting Up SSO Integration

Configure SSO (Single Sign-On) integration using a tenant ID for Descope integration.

In the *Tenant ID* field, enter your *Descope* tenant ID for SSO integration (e.g., `tenant-1234567890`). A save reminder appears at the bottom of the page. Click `Save` to save your SSO configuration. This is optional and only needed if you're using *Descope* for SSO integration.

Deleting an Organization

Permanently delete your organization and all associated data. This action cannot be undone.

Organization deletion confirmation in the Danger Zone section Deleting an organization is permanent and irreversible. This will permanently delete all organization data, member associations, and billing information. Subscriptions will be cancelled. Make sure you have backups of any important data before proceeding. Scroll down to the bottom of the General settings tab to find the *Danger Zone* section, which is highlighted in red. Review the warning message that explains what will be deleted: * All organization data and settings * All member associations * All billing and subscription information (subscriptions will be cancelled) Type your organization name exactly as it appears (e.g., "Pieces Test Organization") in the *confirmation* field to confirm deletion. Click the `Delete Organization` button. You'll be asked to confirm this action one more time before the organization is permanently deleted.

Next Steps

Now that you understand general settings, explore other organization settings like Features Settings to configure team-wide features, or check out Models (including the API Keys tab) to configure AI providers and credentials.