Support

Client portal for customers

For: Your customers

The customer portal is a separate, read-mostly view of your work for the people at your customers. The first four sections are for those people; the last two are for the admins who set it up.

01

Signing in

There is no password. You sign in with a link sent to your email, from app.oneshift.ai/portal.

  1. On “Customer portal sign in” type your email address and click “Continue”. Use the address your provider has on file for you.
  2. The page answers “If your address matches a portal contact, we sent a login link. It is valid for 15 minutes.” It says the same whether or not the address is known.
  3. Open the email “Log in to OneShift” and click the button “Log in to OneShift”. You land on the portal, signed in.
RuleDetail
LifetimeThe link works for 15 minutes.
Single useIt works once. Opening it again shows “Link invalid or expired”. Its button “Go to portal sign in” takes you back to ask for a new one.
Asking againRequest a new link at any time with the same form. A new link replaces the previous one, which stops working.
Too soonIf a link was sent less than a minute ago no new email is sent, so wait for the first one. Requests in quick succession are limited per address.
Staying signed inYou stay signed in for up to 14 days; the session renews while you keep using the portal. “Sign out” in the menu at the top right ends it sooner.
No email? Check your spam folder. Messages come from OneShift’s own sender address and some companies’ filters hold them back at first; ask your IT team to release it. If you are still stuck, ask your provider to send the link again (see the last section).

Your access ends the moment your provider removes you or archives your customer, even while a session is still valid. A changed email address on your contact also ends open sessions and links, and you ask for a new link.

02

What you see

The portal is titled with your provider’s name, “… customer portal”. What it shows depends on what your provider allowed for you, project by project.

SectionAppears whenContent
BoardYou have Board access to at least one project.The issues of those projects, as columns.
StatementsYou have Statements access to at least one project.Your customer’s statements that are In Review, Approved or Invoiced, with status and date.
  • If you have neither, the page says “You don’t have access to any projects yet. Please contact your account manager to be granted access.”
  • A section with nothing in it is hidden. With access but no statements the list reads “No statements found.”
  • A statement shows only if you may see every project it covers. One that covers a project you are not allowed to see is hidden completely.
  • Access changes apply the next time you load the page. You only ever see your own customer’s data.
03

Working on issues

The board is the same board your provider’s team uses, with the same cards, comments and attachments. What differs is who may move a card where.

Create and edit

  1. Click “New issue” in the first column.
  2. Enter a title, choose the project and, if you like, a task, an assignee and a description, then click “Create”.
  3. Click any card to open it. Changes to the title, status, assignee and task save as you make them.
  • The project list holds only the projects you have Board access to. The assignee can be a member of the project’s team or a colleague of yours who also has Board access.
  • Title up to 200 characters; description and each comment up to 5000. The editor takes Markdown, @ mentions and # references to other issues of the same project.

Move along the allowed steps

Drag a card to another column or change its Status on the issue. Your provider decides which moves customers may make. While you drag, columns you may drop on get a green outline and the others are dimmed. A move that is not allowed snaps back with “This status change is not allowed by the workspace workflow.”

Comments, attachments and links

  • Write on the Comments tab and click “Comment”. You can edit or delete only your own comments; your name shows on them.
  • The Attachments tab takes files up to 25 MB each. A file whose name is already on the issue has to be renamed.
  • “Related issues” links two issues of the same project.
  • You can delete only issues you created yourself.

Emails about issues

When an issue you created, are assigned to, took part in or were mentioned on changes, you get one summary email a few minutes after the changes stop, with a link that opens the issue in the portal. You are not mailed about your own changes. The emails stop only when your provider removes your Board access; there is no unsubscribe link.

For the board itself, see the Kanban boards article.

04

Reading a statement

Open a statement from the Statements list. It shows what your provider shows internally, read-only: totals, rates, prepaid balance and the work by task.

  • If your provider wrote a summary, it sits under “Summary”.
  • “Ask about this statement” answers questions from this statement only. Pick a suggestion or type up to 1000 characters and click “Ask”. Answers are marked “✨ AI generated”. For anything else, contact your provider.
  • There is no approval step for you. Your provider can see when you opened a statement.

How a statement is built and what each part means: seeThe customer’s view in the Billing guide.

05

Several organizations

If the same email address is a contact at more than one provider, or at more than one of one provider’s customers, you can switch without a new link.

  1. Open the round menu at the top right (“Open portal menu”). With more than one identity it has an “Organizations” list with the provider and customer of each.
  2. Pick another entry. The portal reloads as that contact; the current one has a check mark.

Each entry has its own access, so Board access at one provider gives you nothing at another. Only contacts that are still active and whose customer is not archived are listed. With one identity the list is not shown.

06

Set up contacts and access

For workspace managers. A contact is a person at your customer who may use the portal. Start from the customer’s page under Customers, tab Contacts. The customer and its projects are described in the Workspace guide.

  1. On the Contacts tab click “Create”.
  2. Enter a Name (2 to 100 characters) and the contact’s Email (up to 200). This address is where login links go.
  3. In Permissions, set the switches for each project, then click “Create”. The toast says “Contact created”.
  4. Send the first login link (next section).

The permission grid

SwitchLets the contact
BoardSee, create, comment on and (if the workflow allows) move the issues of that project, and receive its issue emails.
StatementsSee the project’s statements once they are In Review or later. A statement spanning several projects needs the switch on for all of them.
  • Everything is off for a new contact and for a new project. Nothing is visible until you turn it on, so a project you add later is hidden from existing contacts until you grant it.
  • Archived projects stay in the grid, marked “Archived”. Their switches are kept if the project is unarchived.
  • To change access later, click the contact’s name (or Edit), change the switches and click “Update”. The toast says “Contact updated”.
Turning Board off also stops that contact’s issue emails. It is the only way to stop them. Adding entries from a new project to a statement can hide that statement from a contact who has no Statements access to the new project.