Core Concepts

Permissions

Forge has its own role system, layered on top of whatever your Salesforce profile and permission sets already allow. Both apply: Forge's own role decides which Forge features and admin surfaces you can reach, and Salesforce's own object/field permissions still decide which underlying records and fields you can read or write.

Forge's own roles: Planner, Admin, and Custom

Every Forge user has a role stored in Forge itself, shown as "Planner" or "Admin" on the admin Users page (Admin > Users): Admin can reach every admin-only surface listed below; Planner can build and manage events but not the org-wide admin configuration; Custom is a narrower role an Admin can define with specific permissions per navigation area (read/write per section). This role is independent of your Salesforce profile after it's first set — Forge does not re-check Salesforce on every login and silently reassign you.

The FIRST time a brand-new Salesforce user logs into a tenant, Forge looks at real signals from that user's Salesforce profile and permission set assignments (for example, the System Administrator profile) to suggest a starting role — this promotes a genuinely-privileged Salesforce user to Forge Admin, but it never demotes anyone and never changes an existing user's role on a later login. From then on, an existing Forge Admin manages every user's role directly on the Users page, the same way you'd manage any other setting in Forge — this is Forge's own role management interface, not a mirror of Salesforce.

Naming note

You may see these referred to elsewhere as "forgePlanner"/"forgeAdmin" — that's the same Planner/Admin roles described here, just a different label for them.

How Salesforce permissions flow into Forge

When Forge reads or writes a Salesforce record, it does so using the authenticated user's Salesforce session. Salesforce enforces object-level CRUD permissions and field-level security (FLS) on every operation. If a user's Salesforce profile does not allow Read access to conference360__Attendee__c, they will not see the Attendees tab in Forge.

Blackthorn permission sets

Blackthorn provides managed permission sets that grant the minimum necessary access to the managed-package objects:

  • Blackthorn Events Admin — full CRUD on all conference360__ objects. Intended for event administrators and Salesforce Admins.
  • Blackthorn Events User — read/create/edit access for day-to-day event management. Cannot delete records or change gateway settings.
  • Blackthorn Payments Admin — full CRUD on bt_stripe__ objects. Required for gateway configuration and refund processing.
  • Blackthorn Payments User — read access to transactions and fees. Cannot issue refunds or change gateway settings.

Assign permission sets in Salesforce

Permission sets are assigned in Salesforce Setup > Users > Permission Set Assignments. This governs the underlying Salesforce data access described in this section — it's separate from a user's Forge Planner/Admin/Custom role, which an Admin manages on Forge's own Users page (see "Forge's own roles" above).

Field-level security

If a Salesforce field is hidden from a user via FLS, that field will not appear in Forge — either in the UI or in exports. This is intentional and is how Forge enforces data governance. For example, if your FLS policy hides Contact.Email from a user, they will not see attendee email addresses in the Attendees tab. Forge re-checks the real, requesting user's own FLS on every write to a Salesforce field — not just a shared integration connection's schema access — so a field your Salesforce profile blocks you from editing there stays blocked in Forge too.

Exception: ticket and waitlist capacity

Ticket quantity available and waitlist capacity are the one exception: Forge treats these as its own computed/db-process fields and keeps them editable in Forge even if your Salesforce profile's field-level security locks them there directly.

Sharing rules

Salesforce sharing rules also apply. If your org uses organization-wide defaults (OWD) that restrict access to certain conference360__ records, those restrictions propagate through Forge. Users will only see events, attendees, and transactions that their Salesforce sharing configuration permits.

Admin-only features in Forge

Some Forge features are restricted to users with the Forge Admin role (see "Forge's own roles" above) — this is Forge's own gate, separate from any Salesforce permission set. A few examples out of everything under Admin in the sidebar:

  • Users & roles — inviting users and setting each one's Planner/Admin/Custom role.
  • Payment gateway configuration.
  • Org-level fee management.
  • Beta feature opt-in (/beta page).
  • Email provider configuration.
  • Org settings and object-mapping configuration.
  • Campaign sync and registration sync configuration.
  • Admin audit log.