Getting Started

To get started with barxui, there are a few simple steps to follow.

Registration and Login

To access barxui you first need to register with an email address and a suitably cryptic password.

Navigate to barxui and click the Start Free Trial button at the top right or click Sign In if you have already registered.

Note:

Invite Codes may be supplied by a barxui partner and should be entered if provided.

After completing the registration, you will see the Confirm Your Login dialog.

You should have received an email from us to confirm your email address. The email will contain a link you can click and a numeric code. Click the link to automatically confirm or copy the numeric code and enter into the confirmation dialog manually.

Once you have confirmed your registration email you can login.

Note:

When you login to barxui the first time, a new organisation record will be created for you. You are the ‘subscriber’ for this organisation and your email address is used to uniquely identify you.

If you just want to access your organisations existing barxui account, you should ask the subscriber or admin of that account to invite you. If you have been invited to an existing organisation then after you register and login for the first time you will be connected to this organisation.

After you register and login for the first time, you will see your new organisation details form.

Your Organisation Settings

Open Settings then Organisation. The settings are split across tabs:

TabWhat it is for
DetailsYour organisation’s name, address, contact details and country.
Plan & BillingYour subscription, payment method and invoices (Subscriber only).
UsersThe people in your organisation, and invitations (Subscriber and Admins).
API KeyThe key used to connect other systems to barxui.

Details

Enter a name for your organisation, rather than your email address. This information can be used on printed documents, and is used on your invoices and for tax.

Choose your country and activate the organisation. Activation sets your currency and pricing, and Plan & Billing stays disabled until your organisation has a country.

Note: Once activated, you cannot change the country. Contact support if you need to.

After activation you will see the Plan and Billing page,

Plan & Billing

Plan & Billing is only available to the Subscriber. Other users, including Admins, do not see the tab. If you need a plan or payment change and you are not the Subscriber, ask them.

Your free trial

Every new organisation starts on the free trial plan. It is the default until you select a paid plan, and it lasts 14 days.

You can still select a paid plan at any time, but after 14 days the rest of barxui is locked down. The Plan & Billing tab shows Trial ended with the date.

If you need more time to try barxui, contact barxui support and ask for an extension.

Choosing a plan

If you do not have a paid plan yet you will see Choose a plan.

  1. Pick Monthly or Annual with Select. Paid plans may start with a free trial period before the first charge.
  2. If expansion packs are available, use + and − to add or remove additional packs. Each pack adds resources such as users, agents and AddOns.
  3. Check the Order summary. All amounts are in your organisation’s currency (NZD, AUD or USD) and include tax where it applies.
  4. If you have a coupon code from HEXCOM or your barxui supplier, enter it and click Apply. The total updates.
  5. Click Pay and enter your card details in the secure payment dialog.

Note: barxui never stores your card details. They are held by our payment provider, Stripe. Authorised New Zealand organisations can ask for invoice billing instead. Contact support or your barxui Partner.

Your subscription

Once subscribed, the Your subscription panel shows where you stand:

ShownMeaning
Trial · ends …You have selected a paid plan that starts with a trial period. The first charge is on the date shown.
Trial ended …Your 14 day free trial is over. Select a paid plan to unlock barxui, or ask support for more time.
ActiveYour subscription is running. The next charge date and price are shown.
Active · billed by invoiceYou are billed by invoice rather than by card.
Ends …You have cancelled. You keep full access until that date.
Pauses … / PausedSee Pausing your subscription below.
Payment failedYour last payment was declined. See If a payment fails.
Read-onlyYour organisation can be viewed and exported but not changed.
DeactivatedYour organisation has been deactivated by barxui support. Contact support.

Changing your plan or expansion packs

You can change between monthly and annual, and add or remove expansion packs, yourself.

  1. Go to Settings, Organisation, Plan & Billing.
  2. Click Change plan in the Your subscription panel.
  3. Select the plan you want, and use + and − to set the number of additional expansion packs.
  4. Read the message that appears. It says whether the change takes effect now or at your next billing date, and what you will be charged.
  5. Click Confirm change.

Increases take effect straight away. Changing from monthly to annual, or adding expansion packs, applies immediately. The prorated difference for the rest of your current billing period is charged to your card straight away, and the message shows the amount before you confirm. If your card is declined, nothing changes.

Decreases take effect at your next billing date. Changing from annual to monthly, or removing expansion packs, is booked for your next billing date. You keep your current plan and packs until then, and no credit or refund is given for the unused part of the current period.

A booked change is shown as A change is booked in the Change plan panel. Until the date arrives you can click Cancel booked change to leave your subscription as it is. Making another change replaces the booked one.

Raising some things and lowering others needs two steps. For example, moving from annual to monthly while adding a pack both raises and lowers your subscription, so it cannot be done in one change. Make the increase first, then make the decrease as a separate change.

When you can’t change your plan:

  • Invoiced subscriptions. Contact support to change an invoiced subscription.
  • Subscription set to end. Click Keep My Subscription first, then change your plan.
  • Paused or about to pause. Cancel the pause or restart billing first.
  • Overdue payment. Update your payment details first.

Pausing your subscription

If you will not need barxui for a while, you can pause a monthly subscription for 1 to 3 months.

  • You can pause once in any 12 months.
  • The pause starts at the end of the period you have already paid for, so you keep full access until then and nothing is refunded.
  • While paused you are not billed and your organisation is read-only. Billing restarts on the date shown.
  • You cannot pause during a trial, on an annual plan, or while the subscription is set to end.
  • Before the pause starts, click Cancel pause to undo it at no cost. Once it has started you can click Restart billing on … to end it early, within the minimum pause.

Need longer than 3 months? Pausing is limited to 3 months. If you want to stop for longer, up to a year, cancel your subscription and subscribe again whenever you are ready. Your data is kept for 12 months after the subscription ends, but if you have not subscribed again by then it is permanently deleted, so do not leave it that long.

Cancelling your subscription

Click Cancel subscription. Your subscription does not renew. You keep full access until the end of the current period (no refund is due for it), then your organisation becomes read-only. Until that date you can click Keep My Subscription to carry on.

Important: if you do not subscribe again, your account and all its data are permanently and automatically deleted 12 months after your subscription ends. Export anything you need before then.

If a payment fails

If your card is declined the panel shows Payment failed. Click Update payment details to open the Stripe portal and fix your card. If it is not fixed by the date shown, the organisation becomes read-only.

Read-only organisations

A read-only organisation can still be viewed and exported, but data cannot be changed, deleted or printed. This happens when a subscription has ended, a pause is running, or a payment has been overdue past the grace period. Choose a plan under Choose a plan to resubscribe to restore full access.

Payment method and invoices

  • Payment method shows the card on file and its expiry. Update payment details opens the Stripe portal.
  • Invoices shows your latest three invoices. Older invoices are in the Stripe portal.

Changing the subscriber

Contact barxui support to change who the subscriber is.

Users

The Users tab lists the people in your organisation and any pending invited users. It is available to the Subscriber and Admins. Each user has one of these roles:

RoleCan do
SubscriberEverything an Admin can do, plus Plan & Billing (plan, payment details, cancel, pause) and changing the Subscriber. There is one Subscriber per organisation: the person responsible for paying the bill.
AdminDesign and print, manage data, the file library, AddOns, agents, printers and consoles, edit the organisation’s Details and fonts, and manage users (invite people, change roles). Admins cannot see Plan & Billing or change the Subscriber.
DesignerDesign and print, manage data, the file library, AddOns, agents and printers. Can see the organisation’s Details but not change them, and cannot manage users. No access to consoles.
OperatorConsole use only, with read-only access to data and labels, and printing. No access to the file library.

The Subscriber role cannot be assigned directly. To change the Subscriber, contact barxui support.

Invited Users

To add more users to your barxui organisation:

  1. You need to be an Admin or Subscriber.
  2. You need to invite the perion to be a user.
  3. You will need this persons email address.
  4. You need to know what access level they require.
  5. The invitee has to register and login.

When the user logins, they will be prompted to access accept the invitation to your organisation.

Fonts

barxui includes support for some common fonts that work on all systems, plus over 1000 free Google fonts.

It’s a good idea to limit the number of fonts available when designing labels.

  • the barxui designer will be slower to load if you use too many fonts.
  • dont go crazy with fonts. Less is more!

Search for a Google font and add it by ticking the selection and clicking the Add To Selected button.

Note:

Barcodes need to have a mono-spaced font. Typically this can be OCR B, Courier, Courier New or something like IBM Plex Mono.

Searching for a font by name is possible here, but the Google Fonts site has many more options for searching. You may prefer to use that to find a font then use the name to find it in barxui.

Agents

Agents are installed on Windows computers and allow access to local printers and synchronisation of local data to data tables in barxui.

See the Agents section for more details on installation and configuration.

Note:

Printers connected to your local machine are not shown here. barxui requires a barxui Agent to be installed if you wish to use a local or network printer.

Printers

barxui is able to print to local printers via barxui Agents installed on your local Windows computers.

Once you have connected a barxui Agent you will see printers appear here. Each agent can access many printers. Before using a printer you need to enable it – only enabled printers are selectable when printing.

System Printers

There are two default system printers you can use to generate labels. These create PDF and PNG Image files. The PNG Images are downloaded in a ZIP file.

Important:

You are not able to print to devices like “Fax” or “OneNote for Windows” as these require user interaction (e.g. to enter a file name or phone number) and the barxui Agent is not able to do this for you as it doesn’t have fingers.