Set up Otter Hours
Setup takes about ten minutes: a Jira admin installs the app and maps projects, then each person connects their own Harvest sign-in once.
Before you start
- A Jira Cloud site, and a Jira administrator to install the app.
- A Harvest account. Each person who logs time needs their own Harvest login on that account.
- Otter Hours works with one Harvest account per Jira site.
1. Install the app
- In Jira, open Apps > Explore more apps and search for Otter Hours.
- Choose Get app and review the access request. Otter Hours asks to read and write Jira work items and worklogs, read user details (for time zones and the admin check) and use app storage. It connects to two Harvest hosts only:
api.harvestapp.comandid.getharvest.com. - Confirm the install.
2. Choose the site's Harvest account
- Open the Otter Hours settings page: Apps > Manage your apps, then Configure next to Otter Hours.
- Under Harvest account, choose Connect Harvest and sign in to Harvest with your own login. This sign-in is used only to load the account's projects and tasks for the mapping page.
- If you belong to more than one Harvest account, choose the one this Jira site logs time to.
3. Map projects and tasks
Turn the app on for the Jira projects that log time, choose the Harvest project for each, and choose a Harvest task for each issue type plus a default task. Then choose Save settings. Details are on Admin mapping.
4. Each person connects Harvest
- Open any Jira issue in a project where Otter Hours is on.
- Open the Otter Hours panel from the app buttons under the issue summary.
- Choose Connect Harvest, sign in to Harvest and allow access. Otter Hours uses the Harvest account your admin chose for the site. If it cannot tell which account to use, it asks you to pick one.
Otter Hours acts only for people who connect. Worklogs from people who have not connected Harvest are left alone.
5. Log a first entry
- In the panel, under Log time, keep today's date or pick another day.
- Enter the time spent, such as
1h 30m, and optional notes. - Choose Log time. The entry appears under Your entries on this issue, as a worklog in Jira's Work log tab, and on your Harvest timesheet.
Next: Daily use.