# How to use the Planio Inbox
Updating or creating issues while traveling is quick and easy with Planio Inbox - all you need is email access (e.g., a smartphone) and an internet connection.
{{>toc}}
## Project Inbox Feature
Each project is assigned a unique email address and every user that can create or update an issue in the browser can also do this via email.
This feature is available as standard in all accounts and projects at no extra cost. It is separate from our Pro Feature [Planio Help Desk](https://plan.io/customer-service-and-help-desk/) and works even if you _don't_ have that installed.
## How to use the Project Inbox
### 1. Know your rights
Each user in Planio is assigned one or more roles in a project. These roles determine what rights (permissions) you have in your projects.
Usually you will have the permission to create and update issues in your projects and if that is the case, you can also do this via email. Most changes you can make to an issue in the browser, you can also do via email.
Therefore the general rule is:
If you can do it in the **browser**, you can do it via **email**. If you **can't** do it in the browser, you **can't** do it via email either.
### 2. Use the right email address
Once you have established that you can create or update issues in a project, you'll need to know what the project's **Planio Inbox** email address is. This can be found in the browser.
Go to the relevant project → **Issues** → and then open the side bar (black tab on the right hand side). Here you will see a title "PLANIO INBOX". In the blue box you'll find the email address or Inbox for that project → hover over it and copy it using the copy button that appears.
{{figure(Find the project inbox email address in the sidebar)
![](find-project-inbox-in-sidebar@2x.png)
}}
### 3a. Creating a new Issue via email
Go to your email provider or program and in the "To" Section, add the Planio inbox email address you just copied.
As you are creating a new issue, the email’s subject will be the issue subject. It will be automatically assigned an issue ID just as if you created the issue in the browser.
Remember to use the email address that you have registered to your user account in Planio. This is how Planio knows you are a user and member in that project and are allowed to create issues at all. If you use an email address that is not registered in your account, then Planio will reject the email. (If you are using multiple different email addresses for sending frequently, consider adding them all via *your avatar* → **My account** → **Emails**)
The issue that is created will have your user as the **Author**.
If you write anything in the body of the email it will become the **Description** of the issue.
The body of the email can also be used to specify all task fields, such as **Status** , **Priority** , custom fields etc.
There are a few rules however to make this work:
- **Use the right Syntax.** Planio will recognise that you want to fill out a field if you use the following format: "`Field Name: Field Value`", for example: "`Status: In Progress`"
- **Make sure the field and value are already set up in your account.** Planio won't be able to create new custom fields or values (like priorities, categories, etc.) via email, so you can only use field and values that already exist. If you have a typo in your entry, it won't work either.
- **Use one line via field entry only.** This way you can change multiple fields with one email.
★ **Tip!** If you have done something wrong (e.g. forgotten to fill out a required field or made a typo), Planio will send an auto reply email back to you saying the mail could not be delivered. ★
{{figure(If you write an email that looks like this)
![](create-an-issue-per-email-with-fields@2x.png)
}}
{{figure(It will create an issue like this)
![](new-issue-created-per-email@2x.png)
}}
If you don't use the body to change any fields, all standard settings will be used. We'll talk a little more about standard settings in the [[#Hints-Tips-and-Troubleshooting|Hints, Tips, and Troubleshooting]] section below.
### 3b. Updating an existing Issue via email
This works just the same as creating a new issue but with some slight changes.
Go to your email provider or program and in the "To" Section, add the Planio inbox address you copied earlier.
As you are updating an issue, the email’s subject must contain the issue ID you want to update. This way Planio knows what issue to update. To make sure Planio recognises it as a Planio issue ID it must be written with a Hashtag before the digits and inside square brackets like so: `[#12345]`
If you write anything in the body of the email it will become the **Notes** of that update.
As with creating a new issue, the body of the email can also be used to specify all issue fields, such as **Status**, **Priority**, custom fields etc. If you don't use the body to change any fields, no further changes will be made in the issue.
{{figure(If you write an email that looks like this)
![](updating-issue-per-email@2x.png)
}}
{{figure(It will update the issue like this)
![](issue-updated-per-email@2x.png)
}}
### 3c. Replying to a Planio notification email
If you have Planio email notifications set up, you receive emails for issue updates to your inbox. In cases where they refer to a single issue you can simply click **Reply** in your email program to update that issue in Planio via email. As the issue already exists, you will be updating the issue and you can follow the instructions from section 3b.
### 4. Issue fields list and how to fill them
Here is a useful list for filling out valid fields via email:
| Field name | | Valid Value Formats | Example |
| - | - | - | - |
| Project | →| Exact project name | `Product Launch` |
| Tracker | →| Exact tracker name | `Bug` |
| Assignee | → | Full name
Email address
Login | `Ema Raven`
`raven@example.com`
`Eraven` |
| Priority | →| Exact priority name | `High` |
| Category | →| Exact category name | `Development` |
| Start Date | →| Correct format | YYYY-MM-DD |
| Due Date | →| Correct format | YYYY-MM-DD |
| Estimated hours | → | Whole number
Decimal number | `1`
`1.5` or `1,5` |
| % Done | →| Whole number | `50` |
| Parent issue | → | Issue ID | `123` |
| Private issue flag | → | For private
For not private | `1`, `yes`, `Yes`
`0`, `No`, `no` |
| Files | → | Add an attachment
to upload a file to the issue | |
| Watchers | →