Skip to content
Worklenz
Try for Free

Software projects troubleshooting and FAQ

Most software project problems come from a role, a plan, or a rule that cannot be bypassed, like one active sprint at a time. Find your symptom below. Each answer starts with the short version.

Why can’t I create a software project?

Short answer: Only a workspace Owner or Admin can create projects.

If you are a Member or Project Manager, ask an Owner or Admin. Two other causes:

  • A Free workspace can have up to 3 projects. You see “Sorry, the free plan cannot have more than 3 projects.” Archive or delete a project, or upgrade.
  • Another project already has the same name. Pick a different one.

See create a software project.

Why is there no Reports or Files tab?

Short answer: You are probably a guest.

Guests lose Reports, Files, Insights, Updates, Finance and Docs. They keep Backlog and Releases. Ask an Owner or Admin to change your access if you need more. See the guest role. Insights and Roadmap are also locked on the Free plan, with an upgrade prompt.

Why is Start sprint rejected?

Short answer: Only one sprint can be active at a time.

The message reads Complete the active sprint "{name}" before starting another. Complete the current sprint, choose where unfinished work goes, then start the next one. In the Backlog the button looks clickable even when another sprint is active; in project settings it is disabled with “Complete the current sprint first”. Also check that you set both dates: “Set start and end dates to start the sprint” and “End date must be after start date”. See sprints.

Why can’t I edit a released version?

Short answer: Released versions are read-only by design.

You cannot rename it, change items, or edit the Release field on its issues. Create a new release for follow-up work. See releases.

Why is my story point scale rejected?

Short answer: Values must be comma-separated, non-negative numbers.

The message is “Use comma-separated, non-negative numbers only.” You can enter up to 30 values, each between 0 and 1000. Click Reset to default to return to 0, 1, 2, 3, 5, 8, 13, 21. See story points.

Why don’t I see Connect GitHub?

Short answer: Only a workspace Owner or Admin can connect GitHub.

Others see the button disabled, or a note asking them to ask an admin. On a self-hosted install, “Not configured” means your administrator has not set up the GitHub App. GitHub can be linked only to software projects. See GitHub for software projects.

Can I change a project’s type?

Short answer: No.

A project is General or Software from the day it is created. There is no conversion either way. Create a new software project and move the work over.

Why are there no templates for software projects?

Short answer: Software projects are created blank.

Choosing Software hides the Project Templates and CSV tabs. The project starts with default statuses and an automatic “Sprint 1”.

Where is CSV import for software projects?

Short answer: It is hidden in the New project dialog.

The header menu for Owner/Admin still offers Import tasks from CSV on an existing project, but it is generic task import. Rows are not mapped to story points, issue type, epic, sprint or release, and there is no Jira connection.

Why does the export lack story points and issue types?

Short answer: The task export only includes standard task fields.

Export is a Business feature and skips story points, issue type, epic and release. Sprint appears as Phase. For software fields, use a custom report and Export CSV.

Frequently asked questions

Do software projects cost extra?

Sprints, epics, releases, reports and GitHub are available on every plan. Some settings fields and the Insights, Roadmap and Workload tabs depend on your plan. See permissions and plans.

How many sprints can be active at once?

One per project.

What happens to unfinished issues when I complete a sprint?

You choose Backlog or a planned sprint. Done issues are archived if auto-archive is on, which is the default.

Can I delete a sprint?

Yes. Its issues move to the Backlog. This cannot be undone.

Can I delete an epic?

No. Epics can be archived and restored.

Does the board have WIP limits?

No limit setting exists.

Is there a keyboard shortcut to create an issue?

No. Press / to jump to search.

The branch, commit or pull request title must include the issue key, such as KEY-104, and the key must match a linked project.

Who can see my custom report?

Project visibility is everyone with project task access. Private is only you.

Can guests see sprint progress?

Guests see the Backlog and Releases only, not Reports.