Sanity Library Reference Docs
    Preparing search index...

    Function useProject

    • Returns metadata for a given project.

      Type Parameters

      • IncludeMembers extends boolean = true
      • IncludeFeatures extends boolean = true

      Parameters

      Returns FetcherHookResult<Project<IncludeMembers, IncludeFeatures>>

      A FetcherHookResult whose data is the metadata for the project. members is included only when includeMembers: true; features is included unless includeFeatures: false.

      function ProjectMetadata({projectId}: {projectId: string}) {
        const {data: project} = useProject({projectId})

        return (
          <figure style={{backgroundColor: project.metadata.color || 'lavender'}}>
            <h1>{project.displayName}</h1>
          </figure>
        )
      }

      const {data: projectWithMembersAndFeatures} = useProject({projectId})
      const {data: projectWithMembers} = useProject({projectId, includeMembers: true})
      const {data: projectWithoutMembers} = useProject({projectId, includeMembers: false})
      const {data: projectWithoutFeatures} = useProject({projectId, includeFeatures: false})

      The projectId is resolved in order from:

      1. an explicit projectId option
      2. A legacy ProjectContext (e.g. a <ResourceProvider projectId="…"> with no dataset), then
      3. The active resource (ResourceProvider/SDKProvider)
      4. instance.config.

    Settings

    Member Visibility