[metadata]
apple-mobile-web-app-title: Pinecone Docs
application-name: Pinecone Docs
description: Learn how Pinecone organizations group projects, share billing, and use organization roles to control member permissions and access to resources.
generator: Mintlify
google-site-verification: woTBImNAcYO-gseVfFKIzQrDRUmLWzFjBWrYbYkOTlI
msapplication-TileColor: #002BFF
msapplication-config: /mintlify-assets/_mintlify/favicons/pinecone/JqxxUxUkDTnX7oN2/_generated/favicon/browserconfig.xml
og:description: Learn how Pinecone organizations group projects, share billing, and use organization roles to control member permissions and access to resources.
og:image: https://www.pinecone.io/images/docs_og_image_v2.png
og:image:height: 630
og:image:width: 1200
og:site_name: Pinecone Docs
og:title: Understanding organizations - Pinecone Docs
og:type: website
og:url: https://docs.pinecone.io/guides/organizations/understanding-organizations
twitter:card: summary_large_image
twitter:description: Search through billions of items for similar matches to any object, in milliseconds. It's the next generation of search, an API call away.
twitter:image: https://www.pinecone.io/images/docs_og_image_v2.png
twitter:image:height: 630
twitter:image:width: 1200
twitter:title: The vector database to build knowledgeable AI | Pinecone
viewport: width=device-width, initial-scale=1, viewport-fit=cover

[canonical-links]
https://docs.pinecone.io/guides/organizations/understanding-organizations

[document-links]
/llms.txt: /llms.txt
Architecture: /guides/get-started/database-architecture
Bring your own cloud (BYOC): /guides/production/bring-your-own-cloud
CI/CD: /guides/production/automated-testing
Choose a pod type: /guides/indexes/pods/choose-a-pod-type-and-size
Concepts: /guides/get-started/concepts
Configure single sign-on: /guides/production/configure-single-sign-on/okta
Create a pod-based index: /guides/indexes/pods/create-a-pod-based-index
Create an index: /guides/index-data/create-an-index
Data modeling: /guides/index-data/data-modeling
Decrease latency: /guides/optimize/decrease-latency
Dedicated Read Nodes: /guides/index-data/dedicated-read-nodes
Delete records: /guides/manage-data/delete-data
Enterprise plans: https://www.pinecone.io/pricing/
Error handling: /guides/production/error-handling
Examples: /examples/notebooks
Fetch records: /guides/manage-data/fetch-data
Filter by metadata: /guides/search/filter-by-metadata
Full-text search: /guides/search/full-text-search
Guides: /guides/get-started/overview
Hybrid search: /guides/search/hybrid-search
IDEs & CLIs: /guides/get-started/ai-coding-tools
Implement multitenancy: /guides/index-data/implement-multitenancy
Increase relevance: /guides/optimize/increase-relevance
Increase throughput: /guides/optimize/increase-throughput
Integrations: /integrations/overview
Lexical search: /guides/search/lexical-search
List record IDs: /guides/manage-data/list-record-ids
Local development: /guides/operations/local-development
Log In: https://app.pinecone.io/?sessionType=login
Manage cost: /guides/manage-cost/manage-cost
Manage indexes: /guides/manage-data/manage-indexes
Manage members: /guides/organizations/manage-organization-members
Manage namespaces: /guides/manage-data/manage-namespaces
Manage organization members: /guides/organizations/manage-organization-members
Manage pod-based indexes: /guides/indexes/pods/manage-pod-based-indexes
Manage project members: /guides/projects/manage-project-members
Manage service accounts: /guides/organizations/manage-service-accounts
Migrate a pod-based index to serverless: /guides/indexes/pods/migrate-a-pod-based-index-to-serverless
Models: /models/overview
Monitor performance: /guides/production/monitoring
Monitor usage and costs: /guides/manage-cost/monitor-usage-and-costs
Overview: /guides/get-started/overview
Overview: /guides/index-data/indexing-overview
Overview: /guides/indexes/pods/understanding-pod-based-indexes
Overview: /guides/organizations/understanding-organizations
Overview: /guides/production/production-checklist
Overview: /guides/search/search-overview
Pinecone Docs home page: https://www.pinecone.io
Pinecone console: https://app.pinecone.io/organizations/-/settings/billing
Quickstart: /guides/get-started/quickstart
Reciprocal rank fusion: /guides/search/reciprocal-rank-fusion
Reference: /reference/api/introduction
Releases: /release-notes/2026
Rerank results: /guides/search/rerank-results
Save on costs: /guides/optimize/save-on-costs
Scale pod-based indexes: /guides/indexes/pods/scale-pod-based-indexes
See details: /guides/manage-cost/understanding-cost#imports
Semantic search: /guides/search/semantic-search
Service accounts: /guides/organizations/manage-service-accounts
Sign up free: https://app.pinecone.io/?sessionType=signup
Standard trial: /guides/organizations/manage-billing/standard-trial
Status: https://status.pinecone.io
Support: https://app.pinecone.io/organizations/-/settings/support
Target an index: /guides/manage-data/target-an-index
Test at scale: /guides/get-started/test-at-scale
Troubleshooting: /troubleshooting/contact-support
Understanding cost: /guides/manage-cost/understanding-cost
Update records: /guides/manage-data/update-data
contact Support: https://app.pinecone.io/organizations/-/settings/support/ticket
github: https://github.com/pinecone-io
linkedin: https://www.linkedin.com/company/pinecone-io
organization roles: /guides/organizations/understanding-organizations#organization-roles
owner access: /guides/projects/understanding-projects#project-roles
principal: /guides/production/security-overview#role-based-access-controls-rbac
project owners: /guides/projects/understanding-projects#project-roles
project role: /guides/projects/understanding-projects#project-roles
projects: /guides/projects/understanding-projects
public preview: /release-notes/feature-availability
x: https://x.com/pinecone?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Eauthor
youtube: https://www.youtube.com/@pinecone-io

[structured-data]
{"@context":"https://schema.org","@graph":[{"@id":"https://docs.pinecone.io/#organization","@type":"Organization","logo":{"@type":"ImageObject","url":"https://mintcdn.com/pinecone/HsZKO51bNmpAasdT/logo/Pinecone-Full-Logo-Black.svg?fit=max&auto=format&n=HsZKO51bNmpAasdT&q=85&s=211d0e7bbefc29ce3b8feee1a05d76ee"},"name":"Pinecone Docs","url":"https://docs.pinecone.io"},{"@id":"https://docs.pinecone.io#website","@type":"WebSite","name":"Pinecone Docs","publisher":{"@id":"https://docs.pinecone.io/#organization"},"url":"https://docs.pinecone.io"},{"@id":"https://docs.pinecone.io/guides/organizations/understanding-organizations#webpage","@type":"WebPage","breadcrumb":{"@id":"https://docs.pinecone.io/guides/organizations/understanding-organizations#breadcrumb"},"dateModified":"2026-08-11T14:29:35.935Z","description":"Learn how Pinecone organizations group projects, share billing, and use organization roles to control member permissions and access to resources.","isPartOf":{"@id":"https://docs.pinecone.io#website"},"name":"Understanding organizations","url":"https://docs.pinecone.io/guides/organizations/understanding-organizations"},{"@id":"https://docs.pinecone.io/guides/organizations/understanding-organizations#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://docs.pinecone.io/guides/organizations/manage-billing/upgrade-billing-plan","name":"Admin","position":1},{"@type":"ListItem","item":"https://docs.pinecone.io/guides/organizations/understanding-organizations","name":"Understanding organizations","position":2}]},{"@id":"https://docs.pinecone.io/guides/organizations/understanding-organizations#article","@type":["Article","TechArticle"],"dateModified":"2026-08-11T14:29:35.935Z","description":"Learn how Pinecone organizations group projects, share billing, and use organization roles to control member permissions and access to resources.","headline":"Understanding organizations","image":"https://www.pinecone.io/images/docs_og_image_v2.png","isPartOf":{"@id":"https://docs.pinecone.io#website"},"mainEntityOfPage":{"@id":"https://docs.pinecone.io/guides/organizations/understanding-organizations#webpage"},"name":"Understanding organizations","publisher":{"@id":"https://docs.pinecone.io/#organization"},"url":"https://docs.pinecone.io/guides/organizations/understanding-organizations"}]}

[content]
Understanding organizations - Pinecone Docs
Documentation Index
Fetch the complete documentation index at:
/llms.txt
Use this file to discover all available pages before exploring further.
Skip to main content
🎉 New: Standard and Enterprise orgs get a one-time
$250 bulk import credit
(1 TB), valid through August 30, 2026.
See details
Pinecone Docs
home page
Search...
⌘
K
Ask Assistant
Status
Support
Log In
Sign up free
Sign up free
Search...
Navigation
Manage organizations
Understanding organizations
Guides
Reference
Examples
Models
Integrations
Troubleshooting
Releases
Pinecone Database
Get started
Overview
Quickstart
IDEs & CLIs
Test at scale
Concepts
Architecture
Index data
Overview
Create an index
Data modeling
Data ingestion
Implement multitenancy
Dedicated Read Nodes
Search
Overview
Full-text search
Semantic search
Lexical search
Hybrid search
Reciprocal rank fusion
Filter by metadata
Rerank results
Optimize
Increase relevance
Increase throughput
Decrease latency
Save on costs
Manage data
Target an index
Manage indexes
Manage namespaces
Manage backups
Update records
Delete records
Fetch records
List record IDs
Manage cost
Understanding cost
Manage cost
Monitor usage and costs
Move to production
Overview
Bring your own cloud (BYOC)
Enforce security
Error handling
Monitor performance
CI/CD
Admin
Manage billing
Manage organizations
Overview
Manage members
Manage service accounts
Manage projects
Operations
Integrate with cloud storage
Integrate with AI agents
Local development
Using pods
Overview
Migrate a pod-based index to serverless
Choose a pod type
Create a pod-based index
Manage pod-based indexes
Scale pod-based indexes
Back up and restore
On this page
Projects in an organization
Billing settings
Organization roles
Organization single sign-on (SSO)
Service accounts
See also
Manage organizations
Understanding organizations
Copy page
Copy page
Learn how Pinecone organizations group projects, share billing, and use organization roles to control member permissions and access to resources.
Copy page
Copy page
A Pinecone organization is a set of
projects
that use the same billing. Organizations allow one or more users to control billing and project permissions for all of the projects belonging to the organization. Each project belongs to an organization.
While an email address can be associated with multiple organizations, it cannot be used to create more than one organization. For information about managing organization members, see
Manage organization members
.
​
Projects in an organization
Each organization contains one or more projects that share the same organization owners and billing settings. Each project belongs to exactly one organization. If you need to move a project from one organization to another,
contact Support
.
​
Billing settings
All of the projects in an organization share the same billing method and settings. The billing settings for the organization are controlled by the organization owners.
Organization owners can update the billing contact information, update the payment method, and view and download invoices using the
Pinecone console
.
​
Organization roles
Organization owners can manage access to their organizations and projects by assigning roles to organization members and service accounts. A role determines the permissions that a
principal
(a user, service account, or API key) has within Pinecone. The organization roles are as follows:
Organization owner
(
OrgOwner
): Full control over the organization, including billing, members, service accounts, security, and every project. Inherits
owner access
to all projects in the organization.
Organization manager
(
OrgManager
): Can view organization details and create projects. Organization managers cannot manage billing, members, service accounts, or organization settings.
Organization member
(
OrgMember
): Can view organization details and access the projects they are added to. Organization members cannot create projects or manage organization settings. To grant project access, add the member to one or more projects and assign a
project role
; see
Manage project members
.
Billing admin
(
OrgBillingAdmin
): Can view organization details and manage billing, subscriptions, and usage. Billing admins cannot manage members or organization settings, and they cannot manage projects unless they are also
project owners
.
The following table summarizes the permissions for each organization role:
Permission
Owner
Manager
Member
Billing admin
View account details
✓
✓
✓
✓
Create projects
✓
✓
View billing and usage details
✓
✓
Manage billing details
✓
✓
Invite and remove organization members
✓
Update organization member roles
✓
Manage service accounts
✓
Configure single sign-on (SSO)
✓
Configure audit logs
✓
Update organization name
✓
Delete the organization
✓
​
Organization single sign-on (SSO)
SSO allows organizations to manage their teams’ access to Pinecone through their identity management solution. Once your integration is configured, you can specify a default role for teammates when they sign up.
For organizations that use SSO for authentication, console sessions are re-authenticated at least every 24 hours.
For more information, see
Configure single sign-on
.
SSO is available on Standard and Enterprise plans.
​
Service accounts
This feature is in
public preview
and available only on
Enterprise plans
.
Service accounts
enable programmatic access to Pinecone’s Admin API, which can be used to create and manage projects and API keys.
Use service accounts to automate infrastructure management and integrate Pinecone into your deployment workflows, rather than through manual actions in the Pinecone console. Service accounts use the
organization roles
and
project role
for permissioning, and provide a secure and auditable way to handle programmatic access.
​
See also
Manage organization members
Manage project members
Was this page helpful?
Yes
No
Standard trial
Manage members
⌘
I
x
linkedin
youtube
github
Assistant
Responses are generated using AI and may contain mistakes.
