The Square integration allows you to automatically sync your menu data from Square directly into your Untappd for Business (UTFB) account. Once connected, any changes you make in Square, such as adding, removing, or updating menu items, will automatically appear in UTFB with no manual work required.
To set this up, you’ll need:
- an active UTFB account
- an active Square account with permission to manage integrations
🛑 STOP! BEFORE YOU CONNECT:
To ensure a successful integration, please review the setup requirements below before connecting your Square account. Skipping these steps may result in incorrect container mapping, missing tap numbers, or unexpected menu imports.
Important Notes Before You Begin
Imports include all items in the Square category you select, including out-of-stock items.
We recommend reviewing your Square categories first so you’re not surprised by large imports.The Square sync imports top-level menus only. Nested submenus are not yet supported.
(See “Nested Sections Behavior” below for details and best practices.)If you plan to include non-beer items, please review the “Non-Beer Items Handling” section before importing.
Container Setup in Square
If you want your items to map to specific containers (for example: Draft, Can, or Bottle) in Untappd for Business, you’ll need to use a Size/Price pricing strategy within Square.
- Each size/price pairing in Square corresponds to a container type in Untappd.
- Any pricing strategy that doesn’t specify a size will sync as a single generic size called “Serving.”
Tip: If you plan to display multiple serving sizes on Untappd (e.g., 10 oz pour vs 16 oz pint), make sure those sizes are defined in Square using the Size/Price model before you connect.
You can also use the Container Mapping field to map container names (like "tall" or "small") located inside your POS directly to a specific draft/container in UTFB. These mappings will be reused automatically on future imports. Click here for a short video showing how to get set up.
Tap Number Mapping
If you want your tap numbers in Square to automatically sync to your Untappd for Business menus, you’ll need to include the tap number at the start of each item’s Name field in Square along with a period.
Use this exact format:
YES--> 1. Daisy Cutter >> syncs as Half Acre Daisy Cutter with tap # 1
NO --> 1 – Daisy Cutter or #1 Daisy Cutter >> will not sync correctly
Note: Once tap number mapping is fully available in the integration, Untappd for Business will automatically detect and apply these numbers during menu sync.
Integrate Square and UTFB
In this section:
Locate the UTFB Integration for Square
Image and Description Sourcing
Unlink or Remove the Square Integration
Locate the UTFB Integration for Square
- Log into your UTFB account.
- From the left-hand navigation, go to Integrations.
- Find the Square integration tile and click Connect.
Configure the Integration
- Log into your Square Admin account when prompted.
- Review and accept the requested permissions and terms.
- When connection succeeds, UTFB will display Connected, and a new Square Sync item will appear in your left-hand navigation.
Import Menus from Square
- Click Square Sync in UTFB; then, click Import from Square to open the import panel.
- Select one or more Square menus you wish to import.
- Check the acknowledgment:
“I understand that updates to Square-imported menus are automatically reflected in UTFB, but some items may not match and might need to be corrected manually.” - Click Import.
A progress bar will display real-time import status, including sections and item counts. Any items requiring attention will show notifications.
Match and Review Items
UTFB automatically matches most Square menu items to existing entries in the Untappd database.
Auto-matching handles:
- Item names, descriptions, and prices
- Category mapping (e.g., Beer, Food, Wine)
- Container type and pricing
- Availability status from Square inventory
Manual matching:
- For items that don’t automatically match, click Match Now and search for the specific beverage or item.
- Leave unmatched or hide items that you don’t want displayed.
Container mismatches:
If a container doesn’t match correctly (e.g., draft vs. bottle), select the correct type from the dropdown.
Non-Beer Items Handling
Untappd for Business supports syncing non-beer items (wine, spirits, cocktails, NA beverages, and more) from Square. When these items import, the following rules and limitations apply:
How Non-Beer Items Map from Square
Square sends the following fields during sync:
Item Name
Description
Pricing
Modifier Groups
Category (mapped to UTFB categories such as Wine, Spirits, Food, NA Beverages)
Wine-Searcher Matching (UTFB Premium Plan)
If you have access to Wine-Searcher premium matching:
You can attach Wine-Searcher entries to imported wine items.
Imported Square items will appear with an option to match to Wine-Searcher results when available.
If a wine cannot be automatically matched, you can manually select the correct listing.
20-Item Limit for Non-Beer Items (UTFB Essentials Plan)
The UTFB Essentials plan supports displaying up to 20 non-beer items per synced menu.
This cap is enforced on the Square Sync page.
You can use visibility toggles to choose which 20 items appear on your published menu.
A counter will display how many of the 20 slots you have used.
Image and Description Sourcing
UTFB pulls item images and descriptions from both Square and Untappd, using the following priority order:
Priority Logic
Images will be selected for use in your menus in the following order of priority:
User-selected image/description in UTFB (if you manually override)
Square item image/description
Untappd database image/description (if available)
Placeholder image/empty description (if none exist)
When Square Data Is Missing
If Square does not provide an image or description:
Beer items will use Untappd’s brewery-sourced database information when available.
Non-beer items may require manual updates or Wine-Searcher matching.
Review and Publish Your Menu
After matching:
- Navigate to Menu Management in UTFB
- Your imported menu will appear as Unpublished by default for review.
- Open the menu by clicking on its name and confirm item visibility, pricing, and structure.
- Synced menus can display up to 20 non-beer items for users on the UTFB Essentials plan. Remember to use visibility toggles to select which items appear on your published menu.
- When satisfied, click Publish to make your menu live.
What To Know Post-Integration
After connection, UTFB automatically reflects any changes made in Square:
- Inventory updates: When items go out of stock in Square, UTFB marks them as out of stock and hides them from live menus.
- New items: Items added in Square will appear in UTFB during the next sync.
- Removals: Items deleted in Square disappear from UTFB synced menus.
- Price changes: Price updates in Square appear immediately in UTFB.
Once imported, synced menus will display a Synced with Square label in UTFB.
Certain edits are restricted to maintain accurate synchronization.
Editable in UTFB:
You can update the following without breaking sync:
Item Name
Beer-related fields (style, brewery, ABV, IBU, calories, description)
Designations (nitro, cask, local)
Assigning draft tap numbers
Setting or changing your sort order (e.g., sort by style)
Not editable in UTFB:
These fields MUST be edited in Square and will sync automatically:
Menu, section, or item names
Square category assignment
Structure or hierarchy
Adding/removing items
Default item ordering (aside from UTFB’s sort order)
About Sort Order:
If you choose a sort order in UTFB (for example, “Style”), all items in the synced menu will follow that order.
New items added in Square will also automatically inherit this sort order.
(While you are in the menu, UTFB will show tooltips reminding you where edits are managed.)
Nested Sections Behavior
Square currently supports multi-level section structures, but the UTFB integration imports top-level sections only.
What This Means
Any nested submenu in Square becomes a flat section in UTFB.
Submenus do NOT retain hierarchical relationships once imported.
Examples
Square structure:
-
Beer
Draft
Cans
Seasonal
UTFB result:
Beer - Draft
Beer - Cans
Beer - Seasonal
Best Practices
To ensure clean imports:
Create a dedicated top-level Drinks or Beer menu in Square.
Avoid relying on deep nesting for items you want to sync.
Keep naming consistent to avoid confusion once sections flatten.
Reversion Options
- Revert to Square data: restore original Square info.
- Revert to Untappd data: replace with Untappd database info.
Unlink or Remove the Square Integration
To unlink a specific menu in UTFB:
- Go to Square Sync.
- Open the three vertical dots menu beside the menu name.
- Click Unlink and confirm. The menu will remain in UTFB but stop receiving Square updates.
To remove the integration entirely:
- In UTFB, go to Integrations > Square > Disconnect.
- This removes all Square to UTFB connections. Synced menus remain, but become fully editable.