> ## Documentation Index
> Fetch the complete documentation index at: https://docs.florists.digital/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting Connect

> Fix Connect label printing: labels opening in a browser tab, phones and tablets that can't find the shop computer, and phone codes.

Use this page when labels don't print straight to the label printer through Connect, either from Digital Florists on the computer or from phones and tablets running the [Digital Florists App](https://docs.florists.digital/get-started/companion-app.md).

For other problems, start with **Settings** > **Support** > **Status** in Connect. For pairing, see [Connect pairing problems](https://docs.florists.digital/get-started/connect-pairing-problems.md).

## Labels open in the browser on the computer

Labels should go straight to the label printer with no print dialog. When they can't, Digital Florists opens them in a browser tab so you can still print them. Find what you see below.

| What you see | What it means | Next |
| - | - | - |
| A tab of labels opens, with no message | Labels aren't set to go to Connect. | [Send labels to Connect](#send-labels-to-connect) |
| **Connect isn't running on this computer** | The browser couldn't reach Connect. It may be closed, or the browser is blocking it. | [Check the browser can reach Connect](#check-the-browser-can-reach-connect) |
| A reason such as **Choose the label printer in Connect** or **Finish setting up Connect on this computer** | Connect is running but couldn't print. | Do what the message says in Connect, then print again. |
| **Connect could not accept the labels** | Connect didn't answer, or answered with an error. | Check whether the label came out before printing it again. |
| **Could not open label preview** or **Could not complete the print handoff**, and no tab opens | The browser blocked the tab as a pop-up. | [Allow Digital Florists in Site settings](#allow-digital-florists-in-site-settings) |

If a label went to Connect but didn't print, such as a card message too long for one label, see [When a label doesn't print](https://docs.florists.digital/get-started/connect-label-printers.md#when-a-label-doesnt-print).

### Send labels to Connect

1. In Digital Florists, open [**Settings** > **Connect**](https://docs.florists.digital/settings/connect.md#what-prints-where).
2. Under **Delivery labels**, switch on **Straight to the label printer**. It applies to the shop chosen at the top of Digital Florists. If you have more than one shop, switch it on for each one.
3. Reload Digital Florists on each computer that prints labels.

The dashboard's **Print** button prints what [**Print for each order**](https://docs.florists.digital/settings/general/printing.md#what-prints-for-each-order) is set to. Set it to **Label** to print labels.

### Check the browser can reach Connect

1. **Check Connect is open** in the Windows system tray or Mac menu bar. Each computer that prints labels needs its own copy. See [If Connect isn't running](https://docs.florists.digital/get-started/connect.md#if-connect-isnt-running).
2. **Allow Digital Florists in Site settings**, below. If the browser blocks Digital Florists from reaching Connect, it says Connect isn't running even when it is.

If labels still open in the browser:

> [accordion] Connect is paired with a different shop.
>
> Connect only takes labels from the shop it's paired with, at the web address it was paired from. The shop's name or address is at the top of Connect's home screen. If it's wrong, see [Connect pairing problems](https://docs.florists.digital/get-started/connect-pairing-problems.md).

> [accordion] Connect's printing port was changed.
>
> If **Printing port** under **Settings** > **Advanced Settings** in Connect isn't 3000, restart Connect and set the same **Connect port** on this computer's till. A computer that isn't a till needs port 3000. See [Connect's port was changed](#connects-port-was-changed).

### Allow Digital Florists in Site settings

Chrome asks before a website can reach apps on your computer, and blocks pop-ups until you allow them. If someone clicked **Block** or closed the question, labels open in the browser.

**1. Open Site settings**

On the Digital Florists page, click the icon to the left of the web address, then **Site settings**.

**2. Allow Apps on device**

Set **Apps on device** to **Allow**. In some versions it's called **Local network access**. If you also see **Local network**, leave it as it is.

![Chrome's Site settings with Apps on device set to Allow, below Local network set to Ask](https://mintcdn.com/digitalflorists/8Ff8iLY7sd6I52XS/images/Browser/chrome_site_settings_apps_on_device.png?fit=max\&auto=format\&n=8Ff8iLY7sd6I52XS\&q=85\&s=e526981ff740f1cc4372f8ec521d8bbf)

Apps on device set to Allow.

**3. Allow pop-ups**

Set **Pop-ups and redirects** to **Allow**.

![Chrome's Site settings with Pop-ups and redirects set to Allow](https://mintcdn.com/digitalflorists/8Ff8iLY7sd6I52XS/images/Browser/chrome_site_settings_popups.png?fit=max\&auto=format\&n=8Ff8iLY7sd6I52XS\&q=85\&s=18c7250589c08cf86b87799aa8c3c370)

Pop-ups and redirects set to Allow.

**4. Reload and print**

Reload Digital Florists and print a label. If Chrome asks again, click **Allow**.

Repeat this in each browser, and for each computer login, that prints labels.

## Phones and tablets can't find the computer

In the app, **Settings** > **Connect Printer** says **No Connect printers found on this network**, or labels open the device's own print screen instead of printing straight away.

### Run the two-minute test

This tells you whether the problem is the computer and network, or the phone or tablet.

**1. Update Connect**

On the shop computer, open Connect, go to **Settings** > **Updates** and click **Check for Updates**. If it offers **Restart and Install**, click it. You need Connect 0.11.0 or later.

**2. Find the computer's address**

In Connect, go to **Settings** > **Phone Printing** and check **Let the Digital Florists companion app reach this computer over Wi-Fi** is ticked. Note the address under **Use this address on phones and tablets**, for example `192.168.1.20:3000`.

**Addresses** under **Network Details** lists every address the computer has. If there's more than one, use the one whose first three numbers match the device's address.

**3. Check the device is on the same network**

Find the phone or tablet's IP address.

> [tab] Android
>
> Open **Settings** > **Network & internet** > **Internet** on a Pixel, or **Settings** > **Connections** > **Wi-Fi** on a Samsung, and tap the gear beside your network. The **IP address** is there, sometimes under **View more** or **Advanced**. Names vary between phone makers.

> [tab] iPhone and iPad
>
> Open **Settings** > **Wi-Fi** and tap the info button beside your network. The address is under **IP Address**.

The first three numbers should match the computer's, such as `192.168.1.`. If they don't, see [the guest Wi-Fi checks](#the-browser-cant-open-the-address).

**4. Open the address in the browser**

On the phone or tablet, type `http://` and the address, for example `http://192.168.1.20:3000`. The page is on your own network, so it's fine to continue past a "not secure" warning.

> [tab] Android
>
> Use **Chrome**. The address bar may say **Not secure**. If Chrome shows a warning page, tap **Continue to site**.

> [tab] iPhone and iPad
>
> Use **Safari**. The address bar may say **Not Secure**. If Safari shows a warning page, choose to visit the website anyway.

| What the browser shows | What it means | Next |
| - | - | - |
| A short line of text, even **Not found** | The Wi-Fi and the computer are fine. | [The app finds nothing](#the-browser-opens-the-address-but-the-app-finds-nothing) |
| It spins, then can't open the page | The device can't reach the computer. | [The browser can't open it](#the-browser-cant-open-the-address) |
| It can't connect, straight away | The computer is there, but Connect isn't answering. | [Asleep or not running](#the-browser-cant-open-the-address) |

When the page opens, click **Check This Computer** in Connect. **Last request from a phone or tablet** then shows the time and the device's address.

### The browser opens the address, but the app finds nothing

> [accordion] Local Network is off for the app on an iPhone or iPad.
>
> On an iPhone or iPad, the app needs permission to reach devices on your Wi-Fi, even at a typed address. The browser doesn't, which is why the test can pass. Android has no such switch for the app.
>
> Open **Settings** > **Privacy & Security** > **Local Network** and switch **Digital Florists** on. If it isn't listed, close the app, open it again and tap **Allow** when asked. Check every device that prints.

> [accordion] The app doesn't find the computer by itself.
>
> Type the address under **Use this address on phones and tablets** into the app, without `http://`:
>
> 1. In the app, open **Settings** > **Connect Printer**.
> 2. Type the address under **Manual host** and tap **Save host**.
> 3. Print a label from an order.
>
> The screen still says **No Connect printers found on this network**. That's expected. If the label prints with no print screen on the device, it worked. A typed address stops working if the computer's address changes: see [The computer's address changed](#the-computers-address-changed).

> [accordion] Connect says it isn't discoverable.
>
> **Discoverable on your network** under **Settings** > **Phone Printing** > **Network Details** says whether devices can find the computer by themselves. **No** gives the reason in brackets. Typing the address into the app works either way.
>
> Some Wi-Fi extenders and mesh systems stop devices finding each other even when the browser test works. Type the address into the app.
>
> On Windows, Connect 0.10.x can only be found with Apple's Bonjour Print Services installed. Update to Connect 0.11.0 or later instead.

> [accordion] More than one computer runs Connect.
>
> The app prints to any computer with phone printing switched on under **Settings** > **Phone Printing**, and each needs a label printer chosen under **Settings** > **Printers**. Switch it off on computers that shouldn't print labels. Every computer the app prints to needs the same [phone code](#the-app-asks-for-a-phone-code), if you use one.

### The browser can't open the address

Work through these in order, running the browser test again after each.

> [accordion] The computer is asleep or Connect isn't running.
>
> Devices can only print while the computer is awake and Connect is open in the Windows system tray or Mac menu bar.
>
> > [tab] Windows
> >
> > Open **Settings** > **System** > **Power & battery** > **Screen and sleep**, and set **When plugged in, put my device to sleep after** to **Never**.
>
> > [tab] Mac
> >
> > Open **System Settings** > **Energy** (or **Battery** > **Options** on a laptop), and turn on **Prevent automatic sleeping when the display is off**.
>
> Keep **Launch at login** ticked under **Settings** > **Advanced Settings**. Connect stops when its user signs out or someone switches user. See [If Connect isn't running](https://docs.florists.digital/get-started/connect.md#if-connect-isnt-running).

> [accordion] The computer's firewall or network setting keeps devices out.
>
> > [tab] Windows
> >
> > If the **Check This Computer** card under **Settings** > **Phone Printing** shows **Windows may be keeping phones and tablets out**, click **Fix Network Access**. Connect explains what it will change: click **Fix Network Access** again to go ahead, then choose **Yes** when Windows asks. Connect makes your network Private, removes any firewall rule blocking it and lets devices in. If Windows asks for an administrator's password, someone who has one needs to enter it. Only make your shop's own network Private.
> >
> > If that doesn't fix it, sign in as an administrator and:
> >
> > 1. In **Settings** > **Network & internet**, click **Wi-Fi** (or **Ethernet**), then your network (and **Properties** on Windows 10). Set **Network profile type** to **Private network**.
> > 2. Open **Windows Defender Firewall with Advanced Security** from the **Start** menu. Under **Inbound Rules**, delete each **Digital Florists Connect** rule with a red no-entry icon.
> > 3. In **Windows Security** > **Firewall & network protection** > **Allow an app through firewall**, click **Change settings** and tick **Private** beside **Digital Florists Connect**.
> >
> > On a computer your IT team manages, ask them to allow **Digital Florists Connect** on the shop network.
>
> > [tab] Mac
> >
> > Open **System Settings** > **Network** > **Firewall**. If it's on, click **Options**, check **Block all incoming connections** is off, and set **Digital Florists Connect** to **Allow incoming connections**.
> >
> > On macOS 15 and later, also switch **Digital Florists Connect** on under **System Settings** > **Privacy & Security** > **Local Network**. Until then, Connect shows **Waiting for macOS Local Network permission**.

> [accordion] The device is on guest Wi-Fi, an extender or a different router.
>
> * **Guest or customer Wi-Fi** keeps devices apart on purpose. Join the network the computer uses.
> * **An extender or second router** can put devices on a network of their own. Join the main router's Wi-Fi, or have the second router switched to access point mode.
> * **Some routers, including many 4G routers,** keep wireless devices apart. Plug the computer into the router with a cable, and turn off any wireless isolation setting.

> [accordion] Antivirus software has its own firewall.
>
> Antivirus such as Norton, McAfee, ESET or Bitdefender can replace the Windows firewall. In its settings, mark your shop network as trusted, or allow **Digital Florists Connect**. To test, pause its firewall for a minute and run the browser test again.

> [accordion] A VPN is switched on.
>
> A VPN on the computer or the device can keep them apart. Disconnect it, or turn on its option to allow local network access.
>
> > [tab] Android
> >
> > Open **Settings** > **Network & internet** > **VPN** on a Pixel, or **Settings** > **Connections** > **More connection settings** > **VPN** on a Samsung.
>
> > [tab] iPhone and iPad
> >
> > Open **Settings** > **VPN**, or **Settings** > **General** > **VPN & Device Management**.

## Labels open the print screen on the device

When the app can't reach Connect, it offers to print from the phone or tablet instead.

> [tab] Android
>
> The app says what went wrong, such as **Connect printer unreachable**. **Open Android print** prints on Android's own print screen. After **Connect print not confirmed**, check whether the label came out first.

> [tab] iPhone and iPad
>
> The print options screen opens straight away, with no message unless Connect turned the label down, for example over a phone code.

A label through Connect prints with no print screen on the device. If you see one, run [the two-minute test](#run-the-two-minute-test).

## Connect says it's listening, but devices can't connect

**Check This Computer** tests from the shop computer itself. **This computer is ready** or **Listening on your network** means Connect is answering, not that devices can get through a firewall or Wi-Fi. Run [the two-minute test](#run-the-two-minute-test) from the device, then check **Last request from a phone or tablet**: the device's address there means the network is fine.

## The app asks for a phone code

The phone code is an optional code Connect can require before accepting labels from devices. It's under **Settings** > **Phone Printing** > **Phone Code**. It isn't the pairing code from **Settings** > **Connect** in Digital Florists.

In the app, open **Settings** > **Connect Printer**, paste the code under **Connect access token** and tap **Save token**.

| What the app says | What to do |
| - | - |
| **The saved access token does not match this computer** | Copy the code from Connect again and replace the one in the app. |
| **This computer requires a pairing token**, or **pairing token required** | Enter the code from Connect in the app. |

**Last request from a phone or tablet** in Connect also says when a device's code didn't match or was missing.

While **Require a phone code for companion app printing** is ticked, a new code from **Generate** or **Set Manually** stops every device printing until it's entered on them. Use **Set Manually** to share one code across several computers.

## The label printer doesn't print

The **Connect Printer** screen shows a line for each computer it finds.

| What it says | What to do |
| - | - |
| **Found on network, not responding** | Check the computer is awake and Connect is open. |
| **Printer review required** | See [When a printer needs checking](https://docs.florists.digital/get-started/connect-printers.md#when-a-printer-needs-checking). |
| **Connect setup incomplete** | Click **Finish Setup** in Connect's setup wizard. |
| **Connected, no label printer selected** | Set up the **Label Printer** in Connect under **Settings** > **Printers**. |

For labels from Digital Florists on the computer, see [When a label doesn't print](https://docs.florists.digital/get-started/connect-label-printers.md#when-a-label-doesnt-print).

## The computer's address changed

Your router can give the computer a new address after a restart or power cut, so an address typed into the app points nowhere. Give the computer a fixed address in your router's settings, often called an address reservation or DHCP reservation, for the connection it uses. Your broadband provider can help. A replaced router can also turn the Windows network back to Public.

## Connect's port was changed

Connect uses port 3000 unless **Printing port** under **Settings** > **Advanced Settings** was changed. If it was:

* in Digital Florists, open **Settings** > **Connect**, click **Options** on that till and set **Connect port** to match;
* in the app, include the port, as **Use this address on phones and tablets** shows, such as `192.168.1.20:3100`.

If Connect says **Another program is using Connect's printing port**, quit any other copy of Connect or restart the computer.

## Pairing Connect with your shop fails

See [Connect pairing problems](https://docs.florists.digital/get-started/connect-pairing-problems.md).

## Still stuck? Send us your logs

See [Send us your Connect logs](https://docs.florists.digital/get-started/connect-send-logs.md).

## What's next?

> [card] [Connect settings](https://docs.florists.digital/get-started/connect-settings.md#companion-app-access)
>
> Phone printing, the phone code and the printing port.

> [card] [Send us your logs](https://docs.florists.digital/get-started/connect-send-logs.md)
>
> What to send when these checks haven't fixed it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.