useOrganization

useOrganization returns the organization identifier provided to OrganizationProvider. Use it to reach organization-level services, such as organization settings or users, through backend.organization(id).

Basic usage

import { useBackendStrict, useOrganization } from "@gooddata/sdk-ui";

function MyComponent() {
    const backend = useBackendStrict();
    const organization = useOrganization();

    if (!organization) {
        return <div>No organization configured</div>;
    }

    // Access organization-level services
    const orgService = backend.organization(organization);
    // ...
}

Parameters

None.

Return value

string | undefined: the organization identifier, or undefined when no OrganizationProvider up the tree sets one.

Notes

• Components re-render when OrganizationProvider receives a new organization value.
• There is no strict variant. If your code can’t work without an organization, check for undefined and render a fallback or throw, as in the example.
• The hook only returns the identifier; it makes no backend call. Combine it with a backend, for example from useBackendStrict, to load organization resources.