$ provenance-docs — user guide

accounts & roles

Artist, collector, and gallery roles and permissions.

Accounts & roles

Provenance supports three primary account roles, each with different capabilities and subscription plans.

Roles

Artist

Artists can:

  • Add and manage their own artworks
  • Issue certificates of authenticity (COAs)
  • Create public profiles and publish creator websites
  • Apply to open calls and search for grants
  • Use CRM and mailing list tools (with subscription)

Collector

Collectors can:

  • Catalog artworks in their collection
  • Toggle artwork visibility (public/private)
  • Request provenance research
  • Follow artists and favorite artworks

Galleries can:

  • Manage multiple artist profiles (with artist consent via claims)
  • Invite team members with role-based permissions
  • Create and publish exhibitions
  • Run CRM, mailing list, and operations workflows
  • Post artworks on behalf of represented artists

Profiles vs accounts

Your account is your login identity. Profiles are public-facing personas — an artist CV page, a gallery page, etc. One account can have multiple profiles.

Manage profiles at /profiles.

Galleries can invite team members with granular permissions:

PermissionDescription
ViewRead gallery data
Edit artworksModify artwork records
Manage teamInvite/remove members
CRM accessUse the opportunities board

See Artists & profiles for profile claims and team setup.

Admin access

Platform administrators have access to /admin for analytics, user management, and API key issuance. Admin status is granted manually via accounts.public_data.admin.

Subscription & trial

  • New OAuth sign-ups receive a 14-day trial.
  • Subscription plans are role-based (artist, collector, gallery).
  • Manage billing at /subscription or via the Stripe customer portal.

Some features require an active subscription:

  • Grants AI assistant
  • Opportunities AI assistant
  • Operations module
  • CRM (for some roles)

See Billing for plan details.