Overview

Project Settings is your central configuration hub. From basic details like project name and description to advanced features like API access and webhook integrations, everything that defines how your project operates lives here.

Access Project Settings from the gear icon in your project sidebar or through Settings → Project in the navigation menu.

Settings Tabs Overview

Project Settings organizes configuration into specialized tabs:

Each tab handles a specific configuration domain. Changes save independently—updating budget settings won't affect your integrations.

Details Tab

The Details tab controls fundamental project identity and feature availability.

Basic Information

Project Name: The display name appearing throughout GitScrum. Choose something descriptive that your team recognizes instantly.

Description: Optional context about the project's purpose. Helps new team members understand scope.

Category: Organizational grouping at the workspace level. Useful for filtering and reporting across projects.

Feature Toggles

Enable or disable specific GitScrum features for this project:

• Sprints: Agile sprint planning and tracking
• Time Tracking: Log hours against tasks
• User Stories: Epic and story management
• Wiki: Knowledge base and documentation
• Discussions: Team chat and channels
• Documents: File management and sharing

Disabling a feature hides it from the project sidebar. Data isn't deleted—re-enabling restores everything.

Branding

Upload a custom project logo that appears in the sidebar and project headers. Square images work best (recommended: 256×256px).

Upload: Drag and drop or click to select an image file Remove: Delete the current logo to use the default

Danger Zone

Irreversible actions live here for good reason:

Delete Project: Permanently removes the project and all associated data—tasks, time entries, documents, everything. This cannot be undone. The confirmation requires typing the project name exactly.

Budget Tab

Budget settings track costs against project resources. See Budget Settings for complete documentation.

Key capabilities:

• Resource allocation tracking per team member
• Custom hourly rates by user
• Budget alerts at configurable thresholds
• Cost analysis and forecasting

Integrations Tab

Connect external tools to GitScrum. See Integrations Settings for setup guides.

Native Integrations:

• Slack: Channel notifications for project events
• Microsoft Teams: Same functionality for Teams users
• Discord: Community-friendly notifications
• GitHub: Link commits to tasks (Pro)
• GitLab: Same functionality for GitLab (Pro)
• Bitbucket: Same functionality for Bitbucket (Pro)

External Integrations:

• Zapier: Connect 5,000+ apps via automation
• Make (Integromat): Advanced workflow automation

Webhooks Tab

Send HTTP requests when events occur. See Webhooks Settings for endpoint configuration.

Event categories:

• Tasks: created, updated, deleted, assigned, moved
• Sprints: created, started, completed, deleted
• Projects: updated, members changed
• Time entries: logged, updated, deleted

Each event type can have its own endpoint URL. Test webhooks before relying on them in production.

API Tab

Access project data programmatically. See API Settings for credentials and limits.

What you get:

• API credentials (key and secret)
• Rate limit status
• Usage statistics
• Recent request log

The API allows building custom integrations, automation scripts, and external dashboards.

Work Schedule Tab

Define working time for this project. See Work Schedule Settings for detailed configuration.

Configure:

• Working days (Monday-Sunday toggles)
• Hours per day
• Project-specific holidays

Work schedule affects capacity calculations, sprint planning, and time tracking expectations.

Members Tab

Control project access. See Members Settings for permission details.

Management options:

• Assign teams to project
• Add individual members
• View team member details
• Remove access

Member permissions cascade from workspace roles. Project-specific overrides aren't supported—use workspace team management for role changes.

Navigation Between Tabs

Switch tabs using the sidebar navigation within settings:

1. Each tab highlights when active
2. Unsaved changes prompt before switching
3. Some tabs have sub-tabs (Budget has Allocation, Rates, Alerts, Settings)

Keyboard Shortcuts

Common Workflows

Setting Up a New Project

1. Details: Name, description, category
2. Features: Enable what you need, disable clutter
3. Members: Add your team
4. Integrations: Connect Slack/Teams for notifications
5. Work Schedule: Set correct working days/hours

Enabling Time Tracking

1. Details: Toggle Time Tracking feature ON
2. Budget → Settings: Set default hourly rate
3. Budget → Rates: Configure per-user rates if needed
4. Budget → Alerts: Set budget thresholds

Connecting GitHub

1. Integrations: Select GitHub
2. Authenticate with GitHub OAuth
3. Select repositories to link
4. Configure commit-to-task linking

Creating API Access

1. API: Click "Get Credentials"
2. Copy API key and secret
3. Note rate limits
4. Test with a simple GET request

Permission Requirements

Some tabs may be hidden based on your role. Contact your workspace owner if you need elevated access.

Troubleshooting

Settings won't save: Check your network connection. The save button shows a spinner during save—if it stops without success, try again.

Integration disconnected: OAuth tokens expire. Reconnect by clicking the integration and authenticating again.

API requests failing: Verify credentials haven't been regenerated. Check rate limits haven't been exceeded.

Work schedule not reflecting: Project schedule overrides workspace schedule only when enabled. Ensure the override checkbox is active.

Can't delete project: Only Agency Owners can delete projects. The confirmation must match the project name exactly, including capitalization.

Project Settings gives you granular control over every aspect of your project environment. Configure once, and your project operates exactly how your team needs it to work.