How to connect your Luxafor Signal to Shopify

Set up your Signal to light up and play a sound the moment a new order, refund, or other Shopify event happens — without writing any code.

Before you start

You'll need three things in place before you connect Signal to Shopify:

A Signal already configured and online. If you haven't done this yet, follow the Signal setup guide first. The dashboard at luxafor.app should show your device as connected.
Admin access to your Shopify store. You need to be able to install apps from the Shopify App Store.
(Optional) An audio file uploaded to your Signal. If you want events to play a sound, the MP3 must already be on the device — Shopify cannot upload it for you. See Adding audio files to your device.

Step 1 — Add the Luxafor app to your Shopify store

In your Shopify admin, open the Apps section.
Search for Luxafor in the Shopify App Store, or follow this direct link.
Click Add app and accept the permissions.

The Luxafor app now appears in your Shopify admin sidebar.

Step 2 — Add your Signal to the Shopify app

The Shopify app uses a one-time share code to take control of your device.

In the Luxafor Shopify app, open the Devices tab.
Click Import device via share code (or Import device depending on your version).
In a new tab, go to luxafor.app and sign in.
Select your Signal from the dashboard.
Click Create share code. A popup will appear with a short string starting with share_ — copy it.
Return to the Shopify page and paste the share code into the input field.
Click Next, fill in the device's name and description, and click Save.

Your Signal now appears in the Shopify Devices tab.

One share code per integration. Each share code is meant to be used once. If you ever need to reconnect the device — for example, after uninstalling and reinstalling the app — generate a fresh share code from luxafor.app instead of trying to reuse the old one.

Events are what trigger your Signal: a new order, a refund, a cancellation, and so on.

Open the Events tab from the navigation.
Click Subscribe to an event.
Choose an event from the list. You may need to accept additional permissions for Shopify to share that data with the app.
Click Subscribe.

The new subscription now appears in your Events dashboard. Click on it to expand it — at this point no devices are assigned yet, so nothing will happen when the event fires. Move on to Step 4 to wire up your Signal.

Step 4 — Assign your Signal to the event

Inside the expanded event, click Add device.
Select your Signal from the dropdown of available devices.
Configure the visual response:
- Color — pick the color the device should display when this event fires.
- Pattern — choose a built-in pattern (flash, pulse, sweep, traffic-light, etc.) if you want something more attention-grabbing than a solid color.
(Optional) Configure the audio response — see Step 5 below.
Click Add device.

That's it. As long as your Signal is online, it will react to the event the way you configured it.

You can assign the same Signal to multiple different events with different colors and sounds — this is how a single device can show "new order" in one color and "refund" in another.

Step 5 — Add a sound to the event (optional)

If you've already uploaded an MP3 to your Signal (see Adding audio files), you can play it whenever the event fires.

Open the Events tab and either add a new device configuration or edit an existing one.
Change Audio from None to Sound .
In the field that appears, enter the exact filename of the audio file as it appears on the device (for example, new_order.mp3 ).
Set the volume.
Save the configuration.

Volume recommendation. Keep the volume at or below 80%. Above this, Signal's built-in speaker can sound distorted or uncomfortably loud at close range.

The file must already be on the device. Shopify only stores the filename in its event configuration — it does not store the audio itself. If the MP3 isn't on the device when the event fires, nothing plays. No error is raised; the visual color/pattern still works as configured.

Common issues

My Signal is added but doesn't react to events

Check the Devices tab in the Shopify app — does the device show as online?
Confirm your Signal is connected to Wi-Fi. Open luxafor.app — if it shows as offline there, it's offline everywhere. Restart the device by unplugging it and plugging it back in.
Confirm the event you subscribed to actually fires for the action you're testing. Shopify "Order created" fires on a new paid order, not on draft orders or abandoned checkouts.

The light works but no sound plays

Confirm the filename you entered in the event configuration matches the file on the device exactly, including the .mp3 extension and any capitalisation.
Confirm the file is still on the device — open the device settings at luxafor.app and check the file list.
Confirm the volume is not set to 0 .

Color or pattern changes the moment I close the Shopify tab

If you also have the same device open at luxafor.app in another tab or on another computer, that browser will override the Shopify event's color when its own state changes. Each separate browser session controls the device independently. The fix is usually to close the other tab, or to only use the device through one place at a time.

I want to disconnect Shopify from this Signal

In the Shopify app's Devices tab, remove the device. This releases control without affecting the device itself — it remains configured on your luxafor.app account and can be re-shared at any time.

Where to go next

How to set up your Luxafor Signal light — initial device configuration and audio uploads.
How to build a Signal integration through the cloud API — for custom events Shopify doesn't expose (helpdesk tickets, CI/CD pipelines, anything with a webhook).

Need more help?

If your Shopify events aren't reaching your Signal the way this article describes:

Email: support@luxafor.com

(Mon–Fri, 09:00–17:30 EET)

When you write in, please include your Shopify store URL, the name of the event you subscribed to, and whether the device shows as online on luxafor.app. That triages a Shopify integration question much faster than a screenshot.