Skip to main content

QR Codes

QR codes are the entry point for your customers. Each service point in OKeep has a unique QR code that customers scan to view your menu and place orders directly from their phone.

How QR Codes Work​

  1. You create a service point in the CRM (e.g., "Table 1", "Counter", "Terrace")
  2. OKeep generates a unique QR code for that service point
  3. You print and place the QR code at the corresponding location
  4. A customer scans the code with their phone camera
  5. Your menu opens in their browser -- no app download required
  6. The customer browses, adds items, and places an order
  7. The order appears on your dashboard in real-time, tagged with the service point name
Mobile App Support

Customers who have the OKeep mobile app installed will be redirected to the app automatically when they scan a QR code. The app provides additional features like loyalty points, vouchers, and order history.

Generating QR Codes​

For a Single Service Point​

  1. Go to Service Points in the CRM sidebar
  2. Find the service point in the list
  3. Click the QR code icon in the row actions
  4. A modal opens with a preview of the QR code
  5. Click Download QR to save the image as a PNG file

The downloaded file is named using your restaurant and service point name (e.g., myrestaurant-Table-1-QR.png).

Customizing QR Colors​

If you do not have a QR template set up, the QR code modal shows a simple QR code with color pickers:

  • Foreground -- the color of the QR code pattern (default: black)
  • Background -- the color behind the QR code (default: white)

Your color choices are saved per workspace, so they persist across sessions.

caution

Keep high contrast between the foreground and background colors. Low-contrast QR codes may not scan reliably. Dark foreground on light background works best.

Using a QR Template​

If your workspace has a QR template configured, the modal shows a branded preview instead of the simple QR code. The template includes your logo, text, and design elements with the QR code embedded.

From the template preview, you can:

  • Click Download QR to save the rendered image
  • Click Edit Template to modify the design

To learn how to create and edit templates, see QR Templates.

Downloading QR Codes in Bulk​

When you need QR codes for many service points at once, use the bulk download feature:

  1. Go to Service Points in the CRM
  2. Click Select in the top toolbar
  3. Check the service points you want, or click Select All
  4. Click Download QR Codes
  5. A progress indicator shows the generation status
  6. A ZIP file is downloaded containing one PNG image per selected service point

Each image in the ZIP file is named after the service point (e.g., Table-1.png, Counter.png).

tip

If you have a QR template configured, the bulk download uses your template design for every image. If not, it generates simple black-and-white QR codes.

Printing QR Codes​

Size Recommendations​

The QR code must be large enough for phone cameras to read reliably. Use these guidelines:

Use CaseMinimum QR SizeRecommended QR Size
Table stickers3 cm (1.2 in)5-7 cm (2-3 in)
Table tents / stands5 cm (2 in)7-10 cm (3-4 in)
Wall posters8 cm (3 in)15-20 cm (6-8 in)
Counter displays5 cm (2 in)10-15 cm (4-6 in)
caution

QR codes smaller than 3 cm may fail to scan, especially in low light or from a distance. When in doubt, go larger.

Paper and Material​

MaterialBest ForDurability
Laminated paperTable tents, standsGood -- protects against spills
Vinyl stickersTables, countersExcellent -- waterproof and scratch-resistant
Acrylic standsUpscale dining, permanent displaysExcellent -- professional look
Regular paperTesting, temporary useLow -- replace frequently

Placement Tips​

  • Place at eye level when the customer is seated at the table
  • Use table stands or tents to keep QR codes visible and upright
  • Add a call-to-action near the QR code, such as "Scan to Order" or "Scan to See Menu"
  • One QR code per table is usually enough -- place it in the center or near the edge
  • For counters, position the QR code facing the customer, not the staff
  • Avoid placing near reflective surfaces or under harsh direct lighting that creates glare
  • Keep QR codes away from other printed patterns -- nearby graphics can confuse scanners
tip

Print one QR code first and test it with your phone before printing in bulk. Scan from the distance and angle a customer would use.

What Customers See​

When a customer scans a QR code:

  1. Their phone camera detects the QR code and shows a link notification
  2. They tap to open the link in their browser
  3. Your restaurant's menu page loads, showing all available items with photos and prices
  4. They add items to their cart, choose a delivery mode (pickup or table service), and place the order
  5. The order is sent to your kitchen dashboard immediately

The entire process works in the phone's web browser. No app download, no account creation, and no sign-up is required. Customers who want loyalty features can download the OKeep app later.

Troubleshooting​

QR Code Does Not Scan​

ProblemSolution
Camera does not detect the codeMove closer (15-30 cm from the code) and hold steady
Code is too smallReprint at a larger size (minimum 3 cm)
Poor lightingImprove ambient lighting or use the phone flashlight
Code is damaged or dirtyClean the surface or replace the printed code
Code is on a curved surfaceFlatten or reprint on a flat surface
Phone camera is blurryClean the camera lens, ensure autofocus has time to focus

QR Code Opens Wrong Page​

  • Verify the QR code matches the correct service point in the CRM
  • Check that the service point is set to Active (inactive service points may not load)
  • If you recently re-created a service point, you need to reprint its QR code -- old codes link to the old service point
  • Check your internet connection -- the customer's phone needs internet access
  • Verify your CRM is properly configured with menu items
  • Make sure you have at least one active menu item published

Orders Not Appearing on Dashboard​

  • Confirm you are viewing the correct dashboard for the service point
  • Check that your dashboard is connected (look for the green connection indicator)
  • Try refreshing the dashboard