1. Documentation /
  2. WooCommerce for iOS

WooCommerce for iOS

The official WooCommerce iOS App is available for free from the Apple iTunes Store via WooCommerce.app.

This guide walks you through setup, including how to connect to your store and how to use the app.

Requirements ↑ Back to top

The official WooCommerce iOS App also can be used with the iPad.

Installation ↑ Back to top

Your store should be either

  • Hosted on WordPress.com with a WordPress.com Pro plan (previously called Business or eCommerce plan), or
  • Self-hosted running WooCommerce 3.5 or higher, with the Jetpack plugin installed, connected, and activated (more info on Jetpack at Getting Started with Jetpack)

To install the app, either

  • use your device to visit the Apple App Store, search for WooCommerce by Automattic, and install the app, or
  • use your device to open this link and get started from there: WooCommerce.app

Connect to your store ↑ Back to top

Our welcome screen greets you after installing and launching the official WooCommerce iOS app. Select your login preference by either entering your store address or continuing with WordPress.com. The login process varies slightly, but the end result is the same.

  1. If you start with Enter Your Store Address, do type the website URL of your WooCommerce store in the field provided, and click continue
  2. Next, or if you selected Continue with WordPress.com, type your WordPress.com account email address, and tap Continue
  3. Either type your WordPress.com password and tap Continue, or select Get a login link by email
  4. If you have a choice of sites, tap to select your preference, otherwise tap Continue
  5. The My Store page loads indicating your app is now connected to your WooCommerce store.

Log out of your store ↑ Back to top

To disconnect the WooCommerce app from your store:

  1. Tap the Menu icon on the navigation bar at the bottom-right of the screen
  2. Select the Gear icon at the top right of the screen to access Settings
  3. Scroll down to the bottom of the Settings screen
  4. Tap Log Out

Multiple Stores ↑ Back to top

You can manage any WooCommerce store using the app, provided that it’s connected to your Jetpack account.

  1. Tap the Menu icon on the navigation bar at the botom-right of the screen
  2. Tap Switch store at the top of the screen
  3. Choose another store in your account
  4. Tap Continue to complete the switch

Note that as of version 8.0, the app supports push notifications for all stores connected with the same Jetpack/WordPress.com account.

Multiple Store Admins ↑ Back to top

Multiple people with Administrator or Store Manager user roles can manage a store from their own devices. Each person will need to complete the following steps:

  1. Log into the WooCommerce website via a browser
  2. Go to Jetpack Dashboard and then Connections
  3. Select “Link to WordPress.com
  4. Log in with their WordPress.com account
  5. Select Jetpack Free Plan
  6. The respective user can now log into the app with their WordPress.com Account.

In order to allow Shop managers to view stats, go to Jetpack → Settings → Traffic and enable stats viewing.

Set who can view Jetpack site stats

The My Store page is the default view when launching the WooCommerce iOS app. It is one of four main sections, which are:

  • My Store – high-level overview of sales and top performing products for this day, week, month, or year.
  • Orders – search or filter existing orders, or take payment for new ones.
  • Products – search or filter existing products, or add new ones.
  • Menu – switch stores, and access reviews, settings, and more.

My Store ↑ Back to top

The My Store tab provides sales and visitor data, and gives insight into sales trends. It’s the default view when launching the app, but can be accessed from any other view by tapping the My Store icon next to the navigation bar at the bottom-left of the screen.

The top section of My Store displays Visitors, Orders, and Revenue for the selected period. It can be filtered for Today, This Week, This Month, or This Year by selecting the respective tabs at the top of the sreen.

Bar graphs display an overview of how sales change over time. Tap on an individual bar to view that period’s data.

The bottom section displays top-selling products for the corresponding period.

The My Store tab updates each time you open the app or pull down the screen to manually refresh as needed.

Orders ↑ Back to top

The Orders tab allows access to a list of orders, filter it by status, search for a specific order, and view and manage orders. To access this view, tap the Orders icon on the navigation bar, bottom-left.

Order Filter

Orders can be filtered by Order Status and/or Date Range.

  1. Tap the Filter icon in the top toolbar
  2. Select Order Status to filter by: Any, Pending, Processing, On Hold, Failed, Canceled, Completed, or Refunded.
  3. Select Date Range to filter by: Any, Today, Last 2 Days, Last 7 Days, Last 30 Days, Custom Range (select a Start Date and End Date)
  4. After each filter selection, tap Show Orders to apply the filters
  5. While filters are active a filter count is shown on the Orders page, and Clear All appears as an option in the Filters view. Tap Clear All followed by Show Orders to reset all Order filters.

To search for a specific order or orders:

  1. Tap the Search icon in the top toolbar.
  2. Begin typing. The search will look for matching terms by first name, last name, product, and order number.

View and Manage Orders

View Orders

To view an order in detail, select an individual order in the list or tap the order displayed in the New Order notification.

The Order Detail screen provides details on:

  • Order date, number, customer name, and order status
  • A list of products ordered, quantity, attributes, and prices
  • Payment details
  • A button relative to the order status (e.g. Mark Order Complete for Processing, or Refund if available for Completed)
  • Customer notes
  • Shipping Details
  • Billing info, including customer name, address, and email
  • Order notes – private, system, and public

As of version 9.7, if an order has custom fields, the order details screen in the app will show a View Custom Fields button below the products on the order. Tapping the button opens a list of the custom fields.

Fullfill an Order

  1. Open an order with a Processing status to display the Order detail screen.
  2. Tap Mark Order Complete. The Review Order screen appears.
  3. Verify the product details and shipping information, then tap Mark Order Complete.

Marking an order complete with the app triggers a Completed Order email to the customer, the same as if the order was fulfilled on your site. More info at Email Notifications.

Note: Made a mistake? Upon submitting the order for fulfillment, a message with an option to undo will appear for a short time. Clicking Undo will revert the order back to its original status.

View Product Details

Open the detailed view of any product in the order by tapping on the product. 

Add an Order Note

  1. Open an order and scroll down to the Order Notes section. 
  2. Type to add a note. 
  3. The note is private by default, but can be made visible to the customer by toggling the Email note to customer setting. 
  4. Tap Add in the top-right corner to save the note. 

Contact the Customer

  1. Open an order and scroll down to the Customer section and select View Billing Information.
  2. If a billing address was entered, it can be copied by long-pressing the address area and selecting Copy
  3. If a valid phone number was added during checkout, it will be visible via an elipses menu to its right. Tapping the menu reveals options to Call or Message the customer (messages are sent to all numbers, but only succeeds to mobile numbers).
  4. If a valid email address was added during checkout, it will be visible with an envelope icon to its right. Tap the icon to email the customer.

Products ↑ Back to top

The Products tab allows you to access a list of products that can be sorted, or filtered by stock status, product type or category, searched for a specific product, viewed and managed, and new ones added. To access this view, tap the Products icon on the navigation bar at bottom-right.

Product Sort and Filter

Products can be sorted ascending or descending by either date or name.

  1. Tap on Sort By below the Product name at the top-left of the view.
  2. Tap Date: Newest to Oldest, Date: Oldest to Newest, Title: Z to A, or Title: A to Z to sort products accordingly.
  3. Once selected the product list reloads, showing products in the order specified.
  4. Tap anywhere else on the screen to exit the selection without making a change.

Products can be filtered by Stock Status, Product Status, Product Type, or Product Category.

  1. Tap on Filter below the Product name at the top-right of the view.
  2. Select Stock Status to filter by Any, In stock, Out of stock, On Back order.
  3. Select Product Status to filter by Any, Published, Draft, Pending Review.
  4. Select Product Type to filter by Any, Simple, Variable, Grouped, External/Affiliate.
  5. Select Product Category to filter by one of the product categories configured in your WooCommerce store.
  6. After each filter selection, either tap Show Products to apply the filters, or tap the Back arrow (top-left) to view and select more filters.
  7. While filters are active a filter count is shown on the Product page next to Filter, and Clear All appears as an option in the Filters view.
  8. To reset all Product filters, tap Filters, then Clear All, followed by Show Products.

To search for specific Products:

  1. Tap the Search icon in the top toolbar.
  2. Begin typing. The search will look for matching terms in Product names.

View and Manage Products

View Products

To view a product in detail, tap an individual product on the Products list.

The Product detail screen provides details on:

  • Product images: add or remove images
  • Product name
  • Product long description
  • For Variable products: adding and managing variations
  • For Variable products: adding and managing variation attributes
  • For Grouped products: add/remove products in the group
  • Price: regular price, sale price, sale schedule (from/to), tax status, tax class
  • Product reviews
  • For External/Affiliate products: Product link, product URL, button text
  • Inventory: SKU, Manage stock toggle (quantity, backorders), Stock status (in stock, out of stock, or on back order), toggle to limit one per order
  • Categories: assign, unassign, add category
  • For Downloadable products: Downloadable files: add, remove, file URL, File Name
  • Product short description
  • Product Type: Physical, simple virtual, variable, grouped, external

At the bottom of each Product detail view is a link to Add more details to add the following (visibility depends on product type):

  • Shipping: weight, length, width, height, shipping class
  • Tags: add tag, or select from tags existing in your WooCommerce store
  • Linked products: upsells, cross-sells
  • Downloadable files: from device, from WordPress Media Library, enter file URL

Add a Product

Adding a product in the app requires data similar to when adding a product in your WooCommerce store. Follow the steps outlined below to add a product via the app:

  1. From the Product list view tap the + icon at the top-right of the screen.
  2. Select from Simple physical product, Simple virtual product, Variable Product, Grouped Product, or External product.
  3. Fill in the relevant fields.
  4. Tap Add more details to add, as required by your product, Shipping weight and dimensions, categories and tags, a short description, and linked products.
  5. Under the elipses menu at to the top-right of the screen there are options to Save as draft, Product Settings, or to cancel the product creation. Product Settings contain fimiliar WooCommerce options:
  6. Once the new product configuration is completed click Publish at the top-right of the screen

Share or Delete a Product

A published product can be shared, and a product with any status can be deleted.

To delete a product:

  • Enter the Detail view of the product.
  • Tap the elipses menu at the top-right of the screen.
  • Select Delete.
  • A Remove product prompt appears.
  • Tap Move to Trash to confirm, or Cancel to exit.
  • Confirming will move the product to trash and return you to the Product list view.
  • Cancelling returns you to product detail view.

To share a published product:

  • Enter the detail view of the product.
  • Tap the elipses menu at the top-right of the screen.
  • Select Share.
  • Choose a sharing method from those offered (variety depends on apps installed on your device).

The Menu tab is home to admin tasks including switching stores, accessing your store’s WooCommerce Admin, your store view, reviews, and app settings. To access this view tap the Menu icon on the navigation bar at the bottom-right.

  • The Menu view is headed by the details of the store that the app is currently connected to. The name and URL of the store is visible at a glance. The Switch store link will allow switching to another store.
  • The Gear icon at the top-right of this view leads to app Settings.
  • WooCommerce Admin – launches your WordPress Admin in an in-app browser to perform any tasks that might not yet be natively supported by the app. Click Done at the top-left to exit this view.
  • View Store – launches the customer-facing view of your store in an in-app browser. Click Done at the top-left to exist this view.
  • Reviews – manage your product reviews.

Settings ↑ Back to top

Settings can be found by navigating to Menu and tapping the Gear icon at the top-right of the Menu screen. From here you’ll find the following settings and their respective functions:

  • Plugins – view a list of active plugins on the connected site.
  • In-person Paymentsconfigure this feature for qualifying stores (currently only available to U.S. and Canadian merchants).
  • Help & Support
    • Help Centre – links to WooCommerce Documenation
    • Contact Support – submit a help request to WooCommerce Support
    • My Tickets – view your device-specific support history
    • Contact Email – configure the default email address the app will use
    • View Application Log – for debugging, the latest of which is sent when help is requested via My Tickets
    • System Status Report – drawn from the connected site, helpful as a site overview or to copy for support when requested
  • Experimental Features – a toggle to enable or disable available experimental features
  • Send Feedback – connects you to a form through which you can submit feedback or suggestions
  • Privacy Settings – toggle settings related to what info is collected and shared while using the app
  • About the App – WooCommerce Terms of Service, Privacy Policy, Privacy Notice for California Users, and app version, and Third-party License info.
  • Other – opens your iOS Device Settings
  • Log out – disconnect the currently connected WooCommerce store

Troubleshooting ↑ Back to top

If you’re unable to resolve problems yourself, please do reach out to the team in-app via the Contact Support setting as described above.

Frequently Asked Questions ↑ Back to top

Why do I need Jetpack? ↑ Back to top

The Jetpack plugin enables a connection from your self-hosted site to a WordPress.com account and provides a common authentication interface across disparate server configurations and architectures. More info at: Woo Halo – Why is Jetpack required for mobile apps?

I’m logged in, but my store does not appear in the list to select. Why? ↑ Back to top

It could be one of two reasons.

  • Only WordPress.com stores, and self-hosted sites with WooCommerce and Jetpack plugins installed are displayed in the list of available options.
  • WooCommerce 3.5 or higher is required to be installed and activated on the site you’re trying to connect to. If a store does not meet this requirement, an Update to WooCommerce Required message will display.

How can I restart the application? ↑ Back to top

If the WooCommerce app isn’t responding as you’d expect, you can quit it and then reopen it to try and resolve the issue. To do so, swipe up from the bottom edge of the phone and pause halfway up the screen. Swipe left or right to find the WooCommerce app as necessary, and then flick the WooCommerce app up (and off) the top of the screen. You can then restart the WooCommerce app by tapping on the application icon.

Questions and Feedback ↑ Back to top

Have a question before you download the app? Please fill out this contact form.

Already installed the app and need assistance? Reach out to the team in-app via the Contact Support setting as described above, or get in touch with a Happiness Engineer via the Help Desk.

WooCommerce

The most customizable eCommerce platform for building your online business.

  • 30-day money-back guarantee
  • Support teams across the world
  • Safe and secure online payment