Workspaces

Overview

Workspaces organize your figures by project, team, or client. Create a workspace, switch between projects instantly, and GoFigr remembers where you left off.

Key Benefits for Users

Faster Navigation

• Persistent Workspace Selection: GoFigr remembers your last workspace across sessions
• Quick Switching: Change workspaces with a single click from the navigation bar
• URL-Based Context: Share links that automatically open in the right workspace

Streamlined Organization

• Create Workspaces Anywhere: Add new workspaces directly from the workspace dropdown
• Organization Branding: See your organization’s logo in the workspace selector
• Direct Management Access: Jump to workspace settings from the dropdown menu

Better Team Collaboration

• Organization Logos: Visual identification of which organization owns each workspace
• Workspace Overview: Aggregated counts show activity at a glance
• Consistent Context: Everyone sees the same workspace structure

Features

Workspace Selector in Navigation

The new workspace selector sits prominently in the navigation bar:

Display Elements:

• Current workspace name
• Organization logo (if applicable)
• Grid icon for visual identification
• Dropdown indicator

Dropdown Options:

• List of all accessible workspaces
• Active workspace highlighted
• “Manage” link to workspace settings
• “Create new workspace” option

Persistent Workspace Memory

GoFigr remembers your workspace preference:

How It Works:

1. When you select a workspace, it’s saved to local storage
2. On your next visit, GoFigr automatically selects that workspace
3. URL parameters override stored preference when provided
4. Workspace context follows you across page navigations

Priority Order:

1. URL parameter ?workspace=xxx (highest)
2. Local storage saved preference
3. First available workspace (fallback)

Create Workspace from Dropdown

Add new workspaces without navigating away:

1. Click the workspace dropdown
2. Select “Create new workspace”
3. Enter a workspace name
4. Optionally select an organization
5. Click “Create”
6. New workspace is immediately selected

Organization Selection:

• If you belong to multiple organizations, choose which one owns the new workspace
• Organization determines logo, billing, and team access
• Personal workspaces have no organization

Workspace Overview API

Get a quick summary of workspace contents:

Aggregated Counts:

• Total analyses
• Total figures
• Total assets
• Total stories
• Recent activity count

Use Cases:

• Dashboard widgets
• Activity monitoring
• Workspace selection previews

How to Access

From Navigation Bar

1. Look for the workspace selector (labeled “Workspace:”)
2. Click to open the dropdown
3. Select a workspace to switch
4. Or click “Create new workspace” to add one

From URL

Navigate directly with workspace parameter:

https://app.gofigr.io/home?workspace=ws_abc123

Links containing workspace IDs automatically set context.

From Workspace Settings

1. Click the workspace name in dropdown
2. Select “Manage [workspace name]”
3. Opens workspace settings page
4. Configure members, permissions, and details

Organization Logos

Where Logos Appear

Organization logos display in:

• Workspace selector dropdown
• Workspace header on main views
• Story exports (PowerPoint/Word)
• Shared figure views

Logo Requirements

• Supported formats: PNG, JPEG, SVG
• Recommended size: 200x200 pixels
• Background: Transparent preferred

Setting Up Logos

Organization administrators can:

1. Go to Organization Settings
2. Upload logo image
3. Logo automatically appears across the platform

Workspace Switching

Quick Switch

1. Click workspace name in navigation
2. Click any workspace in the list
3. Page reloads with new workspace context
4. All views update to show new workspace content

What Changes

When you switch workspaces:

• Analysis list updates
• Figure library updates
• Activity feed shows new workspace
• URL updates with workspace parameter
• Recent items clear and reload

What Persists

Across workspace switches:

• User preferences
• Search history (global)
• Navigation state

URL Parameters

Workspace in URLs

GoFigr uses URL parameters for workspace context:

Pattern:

https://app.gofigr.io/[view]?workspace=[workspace_id]

Examples:

• /home?workspace=ws_abc123 - Home with specific workspace
• /import?workspace=ws_abc123 - Import into specific workspace
• /story/story_id?workspace=ws_abc123 - Story with workspace context

Sharing Links

When sharing links:

• Workspace parameter is included
• Recipients see content in correct context
• Works even if recipient has different default workspace

Best Practices

Workspace Organization

1. One Project Per Workspace: Keep related figures together
2. Meaningful Names: Use descriptive names that identify the project
3. Organization Assignment: Use organizations for team workspaces
4. Archive Old Workspaces: Remove or archive completed projects

For Teams

1. Consistent Naming Conventions: Team-wide standards help navigation
2. Shared Workspaces: Use organization workspaces for collaboration
3. Permission Management: Control access through workspace settings
4. Document Purpose: Add workspace descriptions for clarity

Switching Contexts

1. Bookmark Important Workspaces: Save direct links with workspace params
2. Use Keyboard Shortcuts: Quick access to workspace switcher
3. Check Context Before Actions: Verify correct workspace for uploads

Technical Details

Storage

Local Storage Key: gofigr_selected_workspace

• Stores workspace API ID
• Persists across sessions
• Cleared on logout (optional)

API Endpoints

Workspace Overview:

GET /api/v4/workspace/{id}/overview/

Returns aggregated counts and metadata.

Create Workspace:

POST /api/v4/workspace/
{
  "name": "New Project",
  "organization": "org_id" // optional
}

URL Routing

• Workspace parameter read on page load
• Stored preference used as fallback
• Context propagates to child views
• API calls include workspace filter

Performance

• Workspace list cached locally
• Overview counts cached with short TTL
• Lazy loading for workspace details
• Optimistic UI updates

Troubleshooting

Wrong Workspace Selected

If you’re seeing the wrong workspace:

1. Check URL for workspace parameter
2. Clear local storage and refresh
3. Verify workspace access permissions
4. Try selecting workspace manually

Can’t Create Workspace

If workspace creation fails:

1. Check organization membership
2. Verify account permissions
3. Ensure workspace name is unique
4. Check network connectivity

Logo Not Showing

If organization logo doesn’t appear:

1. Verify logo is uploaded in org settings
2. Check image format and size
3. Clear browser cache
4. Verify organization assignment