Skip to main content
A workspace is your organization’s dedicated space in Featul where you manage feedback boards, roadmaps, and changelogs. Each workspace has its own subdomain, members, and branding.

​
Creating a Workspace

1

Check slug availability

Choose a unique slug for your workspace subdomain (e.g., acme for acme.featul.com).The API endpoint workspace.checkSlug verifies if your desired slug is available. Some slugs may be reserved or already in use.
2

Provide workspace details

Fill in the required information:
  • Name: Your workspace display name
  • Slug: URL-friendly identifier for your subdomain
  • Domain: Your company website (used to fetch logo automatically)
  • Timezone: Default timezone for timestamps
3

Automatic setup

When you create a workspace, Featul automatically provisions:
  • Four default boards: Features, Bugs, Roadmap, and Changelog
  • Default tags: UI, Design, Security, Bugs, Support
  • Branding configuration
  • Owner membership with admin permissions
  • Free plan subscription
Your workspace logo is automatically fetched from your domain’s favicon. You can customize it later in branding settings.

​
Workspace Information

Each workspace includes:
  • ID: Unique identifier (prefixed with fl)
  • Name: Display name shown across the platform
  • Slug: Subdomain identifier (e.g., acme.featul.com)
  • Domain: Primary company website
  • Owner: User who created the workspace
  • Plan: Current subscription tier (free, starter, professional)
  • Timezone: Default timezone (UTC by default)

​
Managing Workspace Settings

​
Update Workspace Name

Change your workspace display name at any time: 
await client.workspace.updateName.$post({
  slug: 'acme',
  name: 'Acme Corporation'
})
Requires canManageWorkspace permission or workspace owner role.

​
Update Timezone

Set the default timezone for your workspace: 
await client.workspace.updateTimezone.$post({
  slug: 'acme',
  timezone: 'America/New_York'
})
This affects how timestamps are displayed throughout your workspace.

​
Workspace Plans

Featul offers three subscription tiers:
  • Free: Basic features with limited customization
  • Starter: Custom domains, advanced branding, data imports
  • Professional: All features, advanced analytics, priority support
Upgrade your plan to unlock additional features like custom domains and branding options.

​
Data Management

​
Export Workspace Data

Export all feedback posts to CSV format: 
const response = await client.workspace.exportCsv.$get({
  slug: 'acme'
})
The CSV export includes:
  • Post ID, title, description, and status
  • Upvote counts and board names
  • Author information
  • Images and attachments
  • Creation and update timestamps
CSV exports include all workspace data. Handle exported files securely.

​
Import Data

Import feedback from CSV or migrate from other platforms: 
// Import from CSV
await client.workspace.importCsv.$post({
  slug: 'acme',
  csvContent: csvString
})

// Import from other platforms (Starter/Professional plans)
await client.workspace.importFromCanny.$post({ slug: 'acme' })
await client.workspace.importFromNolt.$post({ slug: 'acme' })
Platform imports (Canny, Nolt, ProductBoard) require Starter or Professional plans.

​
Deleting a Workspace

Permanently delete your workspace and all associated data:
1

Confirm workspace name

Enter your workspace name exactly as confirmation
2

Delete workspace

await client.workspace.delete.$post({
  slug: 'acme',
  confirmName: 'Acme Corporation'
})
Deleting a workspace is irreversible. All boards, posts, comments, and settings will be permanently removed.

​
Permissions Required

Most workspace management operations require either:
  • Workspace owner role
  • Admin role with canManageWorkspace permission
See the Members page for details on roles and permissions.

Build docs developers (and LLMs) love

Get started for freeTalk to us