Support / Using Pilea
Company context
Pilea’s analysis is only as sharp as its understanding of your business. Company context is where you give it that understanding: a plain-language briefing on who you are, what you build, and who you build it for.
There are two layers. Organisation context describes your company once, for every workspace. Analysis context is per workspace and covers the product areas, terminology and known issues that matter for that workspace’s feedback.
Organisation context
Go to Settings → Organization. Below the organisation details you’ll find the About section with three fields:
- Company description - a brief overview of your company, mission, and what you offer.
- Product description - what your product does and how it solves customer problems.
- Target audience - who your product is designed for: roles, company types, and use cases.
If you’d rather not start from a blank page, save your Website URL in the organisation details and click Generate context. Pilea reads your site and fills in any of the three fields that are still empty. Review and edit what it wrote.
Under Goal & context you’ll also find what you told Pilea during setup - your role, team size, what you’re trying to decide, and your goal in your own words. Pilea uses this to ground the reports it writes and the analysis lenses it suggests, so keep it current.
Workspace analysis context
Go to Settings → Analysis (under the Workspace section). Two things live here:
- Analysis context - background Pilea uses when analysing feedback in this workspace: product areas, terminology, known issues. For example: “Checkout” refers to our embedded payment widget, not the cart page. Up to 5,000 characters, and you can attach up to five team-visible documents as reference material. It applies to new mentions from the next analysis run.
- Feedback cleaning - Clean feedback before analysis condenses long feedback, such as support tickets and call transcripts, to its essence before analysis. The original text is always kept and shown; only the analysis reads the cleaned version. You can add optional Cleaning instructions for what to keep or drop.
The same page has Re-analyze workspace, which re-runs analysis on existing mentions with your current context and settings. See Working with mentions.
Why it’s worth five minutes
This context makes Pilea’s skills and analysis smarter. When Pilea classifies a mention, links feedback to backlog items, writes an update, or answers a question in chat, it does so with your descriptions in mind. Feedback that would read ambiguously to a stranger reads clearly to a system that knows your product and your audience.
💡 Tip: Write for a smart new hire, not a search engine. “We sell workflow software” teaches Pilea almost nothing; a couple of concrete sentences about what your product does and who buys it goes a long way.
The payoff compounds: the same context serves every skill and every analysis, so one good briefing improves everything downstream.
Who can edit it
Editing organisation context is restricted by role:
| Role | Access |
|---|---|
| Owner | Can edit |
| Admin | Can edit |
| Member | View-only |
Members can read the context - useful for knowing what Pilea has been told - but only Admins and Owners can change it. That keeps your company’s source-of-truth briefing from drifting with every well-intentioned edit.
Workspace analysis context and feedback cleaning can be edited by organisation Admins and Owners.
For the full picture of what each role can do across Pilea, see Pilea roles and permissions.
ℹ️ Note: If you’re a Member and spot something outdated in the context, flag it to an Admin or Owner - a stale product description quietly degrades analysis quality for everyone.
Keep it current
Company context isn’t a set-and-forget form. Revisit it when:
- You launch a major feature or reposition the product.
- Your target audience shifts.
- Your team starts using new terminology, or a known issue is fixed.
A few minutes of upkeep after each big change keeps Pilea reasoning about the product you ship today, not the one you shipped last year.
Stuck? Email us — a human answers, usually the same day.