What is a project key in LocalPM?

The key is a short code that identifies a project in LocalPM. It shows on the project's card on the dashboard and forms part of the project's address, for example #/projects/WEB/board.

How keys work

• Uppercase: whatever you type in the Key field is converted to uppercase.
• Up to 6 characters: the field won't accept more than six.
• Auto-suggested: as you type the Project Name, LocalPM fills in a key from the first 5 letters of the name, skipping spaces, numbers, and punctuation. "Website Redesign" becomes WEBSI, for example.
• Editable before you create: you can overwrite the suggestion with anything you prefer. Once you've typed your own key, changing the name no longer replaces it.

Choosing a good key

• Keep it short and recognizable: WEB, MKTG, HR, Q3OPS.
• Use a different key for every project. Projects are opened by key, so LocalPM won't let two projects share one. If the key you type is taken, it asks you to choose another. Keys are 2–6 letters or digits and start with a letter.
• Pick something that will still make sense later. You can change the key with Edit project on the project's Overview page, but bookmarks that use the old key will stop working.

Bookmarking a project

Because the key is part of the address, you can bookmark a project view directly, such as its board or backlog. The bookmark only works in the same browser where the project's data is stored. See Where does LocalPM store my data?

Made a mistake?

If you've created a project with the wrong key, open the project's Overview page, select Edit project, and change the key. To remove a project entirely, use Delete on the same page. See How do I reset LocalPM or delete a project?.

For more on setting up a new project, see Creating a Project From Scratch: LocalPM Setup Guide.