Bulk Documentation
Getting started

Select an entity

Choose which plant to work in on the Choose a plant screen, understand when Bulk picks one for you, and request access to a plant you cannot yet open.

Selecting an entity is how you tell Bulk which site you want to work in. In Bulk an entity is a single manufacturing site you operate — a factory, workshop, or fabrication plant. Bulk calls these plants or sites as well, and the screen where you choose one is headed Choose a plant. Everything you do next — production, quality, scheduling, people, audits — happens inside the plant you pick, so choosing the right one is the first thing you do after signing in.

Each plant is a self-contained workspace with its own orders, machines, and team. Picking a plant sets your working context; Bulk then shows only that plant's data until you switch to another one.

When you see the Choose a plant screen

Bulk decides whether to show you the plant picker based on how many plants you can open:

  • Access to one plant. Bulk opens it for you automatically and takes you straight to your workspace. You never see the picker.
  • A plant you used before. When you return, Bulk reopens the last plant you worked in and skips the picker.
  • Access to more than one plant, with none remembered. Bulk shows the Choose a plant screen so you can pick where to start — for example on your first sign-in.

You can also open the picker yourself at any time. Use the site switcher at the top-left of the Bulk header (it shows Hub / [your plant] with the plant's short code beneath), open it, and select See all sites. This returns you to the Choose a plant screen even when a plant is already open.

The Bulk site switcher dropdown open, showing the current plant Leeds Fabrication Plant and a See all sites option.
Open the site switcher and select See all sites to return to the Choose a plant screen at any time.

getting-started.select-entity-01

Before you start

  • You are signed in. The plant picker only appears after you sign in. See Sign in to Bulk.
  • You have access to at least one plant. An administrator grants you access to the plants you work in. If you can sign in but no plants appear, you have an account but no plant access yet — ask your administrator to add you.

A plant you can open is one an administrator has added you to. Plants in your organization that you have not been added to still appear on the screen, but as locked cards you cannot enter until you are granted access. Requesting that access is covered below.

Choose a plant

On the Choose a plant screen, each plant you can open is shown as a card. To select one:

  1. Find the plant you want. The masthead reads Choose a plant with a short summary of your whole network — total Assets, network OEE, and available People — across every plant you can see.
  2. Select the plant's card. You can select anywhere on the card; the Enter → hint on the card confirms it is the button that opens the plant.
  3. Bulk opens that plant and takes you to where you were heading — normally your Hub home.
The Choose a plant screen with a Choose a plant masthead, a search and filter toolbar, and a grid of plant cards showing live metrics.
The Choose a plant screen: pick a card under Your plants to open that plant.

getting-started.select-entity-02

What each plant card shows

A plant card is a live snapshot of that site, so you can pick where you are most needed at a glance:

  • Name and short code. The plant's name (for example Leeds Fabrication Plant) with its short code beneath (for example LEEDSFABRI).
  • Region. The plant's time zone, shown next to a location pin.
  • Assets. How many machines the plant has, split into running, paused, and idle. An asset is a machine or piece of equipment on the floor.
  • OEE. The plant's Overall Equipment Effectiveness — a standard manufacturing score, shown as a percentage, for how effectively its equipment is being used.
  • People. How many people are available at the plant right now.

Find a plant quickly

When you have access to many plants, use the toolbar above the cards:

  • Search. Type in the field marked Search by plant name, code, or region… to filter the cards. Search matches a plant's name, its short code, its legal-entity code or name, and its time zone.
  • Filter. The All / Plants / Partners control narrows the list by kind. Plants are the sites you can step into; Partners is reserved for external contract partners and is not yet available.
  • Count. The line on the right shows how many sites are in view — for example 12 sites, or 3 of 12 while a search is active.

If a search or filter matches nothing, Bulk shows No sites match your filters. with a Clear filters button to reset the view.

Request access to a locked plant

If your organization runs plants you have not been added to, they appear as locked cards marked No access. A locked card shows You don't have access to [plant] and the hint Ask the site admin to add you to this plant. You cannot open a locked plant, but you can ask for access without leaving the screen:

  1. On the locked card, select Request access →.
  2. Bulk records your request and confirms with the message Access requested. The site admin has been notified.
  3. The card updates to show Access requested so you know your request is pending.

An administrator for that plant reviews the request and grants access. Once they do, the plant becomes a normal card you can open. Requesting access again while a request is already pending does not send a duplicate.

A locked plant card marked No access, with a padlock and a Request access link.
Plants you have not been added to appear as locked cards; select Request access to ask an administrator for entry.

getting-started.select-entity-03

Example: choosing a plant at Granite Peak Manufacturing

Dana Winters works for Granite Peak Manufacturing, a UK precision-fabrication company, and runs its Leeds Fabrication Plant. Because Leeds is the only plant she has been added to, Bulk opens it automatically each time she signs in — she goes straight to the Hub without a picker.

Later, Granite Peak brings a second site online, a Sheffield Machining Plant, and an administrator adds Dana to it. Now, when Dana opens the site switcher and selects See all sites, Bulk shows the Choose a plant screen with two cards. She glances at the snapshots — Leeds shows twelve assets running and an OEE in the 80s, Sheffield shows a lower count while it ramps up — and selects Leeds Fabrication Plant to start her shift where the work is. When she needs to check on Sheffield, she opens the switcher again and picks it in a moment.

A third Granite Peak site, a Hull Coating Plant, appears on the screen as a locked card marked No access, because Dana has not been added to it. She selects Request access →, sees Access requested. The site admin has been notified., and carries on — the Hull administrator can grant her access when it is needed.

Expected result

After you select a plant:

  • Bulk opens that plant and lands you in your Hub home (or the page you were originally heading to).
  • The plant becomes your current site: its name and code show in the site switcher at the top-left of the header.
  • Bulk remembers your choice, so next time you sign in it reopens the same plant and skips the picker.
  • You can switch to another plant you can open whenever your work moves between sites. See Switch operational context.

Availability and limits

Selecting a plant is generally available and is the standard way every Bulk user chooses a site.

  • Single-plant auto-select. When you can open only one plant, Bulk selects it for you and does not show the picker. This is expected — the picker only helps when there is a real choice to make.
  • Every active plant in your organization is listed. The screen shows all active plants in your organization: the ones you can open first, then any locked ones you can request access to. It is not limited to plants you already belong to.
  • Partners is not yet available. The Partners filter and the Partner sites section are placeholders for a future capability (read-only views shared by external contract manufacturers). They do not list anything today.
  • Live snapshots. The numbers on each card — assets, OEE, and people — are live and can take a moment to appear when the screen first loads.

If something goes wrong

  • No plants appear. If the screen reads No plants available ("No plants have been configured for your organization yet. Contact your administrator to set up your first plant."), your account has no plant access yet, or your organization has not set up a plant. Contact your administrator to be added to a plant.
  • A plant you expect is locked. If a plant shows No access, you have not been added to it. Select Request access → on its card, then wait for an administrator to grant access.
  • A card shows Offline. If your connection drops, cards switch to an Offline state and show the last data Bulk received ("working from cache"). Select Reconnect on a card once your connection returns to refresh the screen.
  • A card shows an error with Retry. If a plant's live snapshot fails to load, its card shows an error with a Retry link. Select Retry to load it again. You can still open the plant even if its snapshot is briefly unavailable.
  • Your search finds nothing. If you see No sites match your filters., select Clear filters to show every plant again, then refine your search.