flamel
DOCS

Glossary

Key terms used throughout Flamel and these docs.

Bookmark this page — most confusion in Flamel docs comes from these terms.

Core model

TermWhat it means
OrganizationTop-level container for your whole account: users, billing, permissions, approval workflows. One Organization can hold one or many Hubs.
HubThe franchisor (corporate). Distributes content, playbooks, brand standards to all Workspaces underneath. In multi-brand setups, you can have multiple Hubs in one Organization.
WorkspaceAn individual location / franchisee. Has its own social accounts, posts, ads. Receives Hub content as read-only.
OwnerThe primary user on a Workspace. Typically the franchisee or location manager.
LocationThe row in the Hub Locations table for a Workspace — address, phone, hours, custom variables. Used in ad targeting, post personalization, and reporting. Each Workspace has one.
BrandInformal name for the franchisor entity. Usually maps 1:1 with a Hub.
The SwitcherUI control in the top-left for moving between Hub and Workspace contexts. See The Switcher.

Roles

TermWhat it means
Super AdminOrganization-wide access to everything.
AdminManage content + settings for assigned Workspaces.
EditorCreate / edit / publish content for assigned Workspaces.
ViewerRead-only access to assigned Workspaces.
GuestLimited external user — read-only on specific surfaces, doesn't count toward seats.
TermWhat it means
PlaybookA Flamel campaign template. Hub creates once; Workspaces opt in to deploy. Generates Meta Campaigns / Ad Sets / Ads automatically.
Opt-InThe action a Workspace takes to deploy a Playbook for their location.
Ad ConfigurationPer-Workspace targeting profile — audience types, default targeting, lead form, CTA. Playbooks pull from this at deploy.
Audience TypeA named targeting preset (Database, Mass, Lookalike, Retargeting). Hub-defined; Workspace-customized.
Custom AudienceA specific list of people in Meta (CRM upload, website visitors, lookalike). An audience type may include or exclude one.
Command CenterCross-Workspace dashboard for monitoring and bulk-editing campaigns. Hub-only.
Instant Form / Lead FormMeta's in-app form that captures leads without leaving Facebook/Instagram. Built in Meta, synced into Flamel.
Meta PixelJavaScript on your website that tracks conversion events, builds retargeting audiences, and powers Sales-objective campaigns.
CBO (Campaign Budget Optimization)Meta distributes campaign budget across ad sets automatically based on performance. Recommended for most.
fEMV (Franchisee Earned Media Value)Estimated dollar value of organic social activity, based on equivalent advertising CPM.

Billing

TermWhat it means
Monthly BudgetThe ad-spend amount a Workspace is billed each cycle. Set by Hub.
SubscriptionThe Stripe recurring charge that collects the Monthly Budget.
InvoiceA Stripe-generated record of each charge (paid, open, failed, void).
Management FeeOptional fee Hub adds on top of (or subtracts from) the ad budget.
One-Time IncreaseA single extra charge for budget bumps mid-cycle, without changing the recurring amount.
Playbook AllocationCommitted spend from opted-in Playbooks, counted against the Monthly Budget.
Workspace BillingThe Stripe-powered ad-spend billing flow (franchisees paying for ad budget).
Flamel SubscriptionWhat the Hub pays Flamel for its own platform subscription — separate from Workspace Billing.

Content

TermWhat it means
BroadcastA Hub-published post that fans out to every Workspace's connected accounts.
TemplateA reusable on-brand layout (post, ad, story, seasonal). Hub creates and distributes; Workspaces customize within limits.
Post IdeaA captured content idea — can be developed into a full post later. Hubs can share ideas with Workspaces.
Brand KitCentralized brand assets — colors, fonts, logos, voice, content guidelines. Hub-defined; flows to all Workspaces.
Custom VariableA per-Location data field referenced in posts/ads with {{custom.field_key}} syntax. Example: {{custom.local_offer}} resolves to each Workspace's offer text.
Luna AIFlamel's brand-aware AI assistant for captions, copy improvements, hashtags, and content ideas.
Approval WorkflowPer-Workspace content review rules. Posts route to designated approvers before publishing.

Status terms

TermWhat it means
In Review (playbook)Workspace submitted; Hub needs to approve creative before deploy
Changes RequestedHub asked for media updates — Workspace resubmits
Active (campaign or budget)Live, running
PausedTemporarily stopped; can be resumed
Past DueStripe payment failed on last invoice
No Payment MethodWorkspace hasn't added a card or bank account yet
Connected / Expiring Soon / DisconnectedSocial account token states

Acronyms quick reference

AcronymStands for
CBOCampaign Budget Optimization (Meta)
CPCCost Per Click
CTRClick-Through Rate
CPMCost Per Mille (per 1,000 impressions)
ROASReturn on Ad Spend
fEMVFranchisee Earned Media Value
OAuthAuthorization protocol — how Flamel connects to social platforms
CRMCustomer Relationship Management — for customer audience uploads
AEMAggregated Event Measurement (Meta's iOS 14+ conversion framework)