WooCommerce for Android

The official WooCommerce for Android App is now available for free from the Google Play Store via WooCommerce.app.

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

Requirements ↑ Back to top

  • A WordPress site with the WooCommerce plugin installed and activated
  • A device running Android 5.0 and higher
  • Jetpack plugin installed, activated, and connected to a WordPress.com account

Installation ↑ Back to top

Your store should be:

  • Hosted on WordPress.com with a Business or eCommerce plan
    or
  • Self-hosted running WooCommerce 3.5 and higher with the Jetpack plugin installed, connected, and activated. More info on Jetpack at: Getting Started with Jetpack.

To install:

  • Use your device to visit the Google Play Store, search for WooCommerce by Automattic, and download.
    or
  • Use your device to open this link and download at: WooCommerce.app.

Connect store to the Android app ↑ Back to top

WooCommerce Android supports several methods for logging in, after which you can select a store to connect to the app.

Our Welcome screen will display upon downloading the app.

  1. Select LOG IN. This takes you to the Login with Site Address screen.
  2. Enter the Site Address (URL): The site address of your WooCommerce store. For example: www.mystore.com
  3. Click NEXT: You’ll be taken to a screen where you can choose to either login with the email address associated with your wordpress.com account, or with Google.

Log in with your email address ↑ Back to top

To log with your email address:

  1. Enter the email address associated with your WordPress.com account. Note: WordPress.com and Jetpack are connected.
  2. NEXT. The Magic Link screen will appear.
  3. Select whether to use Magic Link or enter your password. Magic Link sends an email with a link to complete the login experience without entering a password.
    • Select SEND LINK to use Magic Link. Another screen displays with prompts you to tap OPEN EMAIL to be routed to your email app. Locate the email containing a link to open the app, and tap the link to continue.
    • Tap Enter your password instead to skip Magic Link. The Enter Password screen appears. Type your password, and tap NEXT to finish the authentication process.

If login is successful, and the site entered matches the authenticated account, and the site has WooCommerce installed, you will have successfully logged into the App and will be routed to the home screen.

Log in with Google ↑ Back to top

To log in using a Google account connected to your WordPress.com account:

  1. Select Log In with Google.
  2. NEXT.
  3. Choose an Account from the list.

If login is successful, and the site entered matches the authenticated account, and the site has WooCommerce installed, you will have successfully logged into the App and will be routed to the home screen.

Log out of your store ↑ Back to top

To log out of your store:

  1. Open the upper-right hamburger menu on the toolbar. A drop-down menu will appear.
  2. Select Settings. The Settings screen will appear.
  3. Select LOG OUT ACCOUNT. A confirmation box will appear.
  4. Confirm by tapping LOG OUT when prompted. Or select Back, if this action was in error.

If logout is successful, the app loads the Welcome screen.

Select a Store ↑ Back to top

On the Store Selector screen, note that:

  • 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. If a store does not meet this requirement, an Update to WooCommerce 3.5 required message will display.

Connect your WooCommerce store to the Android app:

  1. Select a store from the list of options if there is more than one. A store will be selected automatically if it is the only option.
  2. CONTINUE.
Multiple stores vs. one store.

The Main screen appears when your account is authenticated and your store is connected.

Multiple stores ↑ Back to top

At this time, it is not possible to simultaneously manage multiple WooCommerce stores using the WooCommerce Android app.

Connect a different store ↑ Back to top

  1. Select the three dots in the upper right corner and tap settings.
  2. Tap on Selected Store
  3. Choose a new store from the list

Note, you will only be able to choose sites that are connected to your WordPress.com account via Jetpack. If you need to use a different account, log out and back in with the other account.

Multiple Store Admins ↑ Back to top

Multiple people (with Administrator or Store Manager user roles) can manages stores from their own devices. Each person will need to complete the following steps:

  1. Log in to the website via a browser.
  2. Visit Jetpack > Dashboard and go to Connections.
  3. Select Link to WordPress.com (see below).
  4. Log in with your (the Store Manager’s) WordPress.com account.
  5. Select Jetpack Free Plan.

This user can now log in to the app with their WordPress.com account.

Getting Started ↑ Back to top

The Main screen launches when opening the WooCommerce Android app. There are five major sections:

  • My Store – High-level overview of sales, pending orders, and trends.
  • Orders – Filterable list of all store orders from newest to oldest.
  • Notifications – Latest new order and product review notifications for the connected store.
  • Settings – Management of privacy, notifications, and logout.
  • Help – FAQs and the option to contact one of our Happiness Engineers.

Navigation is divided into two modes:

  • On the bottom bar for quick access between the most-used screens are My Store, Orders, Notifications.
  • On the top toolbar is a hamburger menu with drop-down for Settings and Help & Support.

Manage store with the Android app ↑ Back to top

Use the WooCommerce Android app to track data, interact with orders and customers, and be notified of new orders and reviews.

My Store ↑ Back to top

The My Store tab provides sales and visitor data, alerts you to pending orders, and gives insight on sales trends.

To get started, tap the bottom-left My Store icon.

The top section of My Store displays Visitors, Orders, and Revenue for the selected period. Data can be viewed for:

  • Days – past 30 days
  • Weeks – past 13 weeks
  • Months – past 12 months
  • Years – past 5 years

Bar graphs display an overview of how sales change over time.

Tap on an individual bar to view that period’s data.

The middle section only appears when there are pending orders waiting to be fulfilled. More info on order statuses at: Managing Orders.

Tap VIEW ORDERS to go directly to the Orders screen that displays all pending orders with Processing status.

The bottom section displays top-selling products for:

  • Today
  • Past Week
  • Past Month
  • Past Year

The My Store tab updates each time you open the app. Or pull down the entire screen to manually refresh as needed. Auto-refresh is planned for the future.

Orders ↑ Back to top

The Orders tab allows you to access a list of orders, filter by status, search for a specific order, and view and manage orders.

To get started, tap the bottom-middle Orders icon.

Filter

To filter the Orders list by a single order status:

  1. Tap the Filter icon in the top toolbar.
  2. Select an order status to filter by: Pending Payment, Processing, On Hold, Completed, Canceled, Refunded, or Failed.
  3. APPLY FILTER.

All orders fitting the selected filter are then listed by period, starting with the most recent.

Search

To search for a specific order:

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

View and Manage Orders

View Order

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 and status
  • Products ordered, prices and quantity
  • Customer information, including billing and shipping
  • Payment information, including order total, payments, refunds, coupons, and how the order was paid
  • Order notes – private, system, and public

Manage Orders

You can manage orders from the Order Detail screen, which is accessed by tapping an individual order.

To fulfill an order:

  1. Open an order that is in Processing status to display the Order Detail screen.
  2. Tap FULFILL ORDER. The Order Fulfillment screen appears.
  3. Verify the product details and shipping information, then MARK ORDER COMPLETE to finish fulfilling the order.

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.

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

To view product details of an order:

The DETAILS of products ordered become available when the order is fulfilled. Tap DETAILS to view.

To add an order note:

  1. Open an order to access the Order Detail screen.
  2. Scroll down and select ADD A NOTE. The Add Note screen appears.
  3. Enter a note.
  4. Choose to keep the note private (default) or to make visible to the customer by toggling the Email Note to Customer option on or off.
  5. Tap ADD in the upper-right corner to save.

To contact the customer:

  1. Go to the: Individual order > Order Detail screen > Customer Information section > Show Billing.
  2. Select a method of contact:
    • Send an email by tapping the envelope next to the customer’s email address. This option is only available if an email address is entered during checkout.
    • Send a text message by opening the hamburger menu and selecting Message. This option is only available if a valid phone number is entered during checkout.
      • The app sends a text message to all numbers, but the attempt is only successful if is a mobile number.
    • Call the customer by opening the hamburger menu and selecting Call. This option is only available if a valid phone number is entered during checkout.

The My Orders tab updates each time you open the app. Or pull down the entire screen to manually refresh as needed.

Notifications ↑ Back to top

To get started, tap the bottom-right Notifications icon.

The Notifications tab displays two types of notifications for the connected store:

  • New Order – a new order was received. Tap the notification to open it in the Order Detail screen. More info in Orders section above.
  • Product Review – a new product review has been submitted. Tap the notification to open it in the Review Moderation screen. More info in the next section.

A red dot appears above the Notifications icon when you have a new notification.

Note: Only the latest New Order notification is currently visible on the Notifications screen. To view all new orders, go to the Orders tab.

Review Moderation

To approve, unapprove, or mark a product review as spam or trash:

  1. Open the Product Review Notification either via an alert you received or from the Notifications tab. The Product Review Detail screen will appear.
  2. Select an option:
    • Approve/Unapprove – Mark the review approved. Or if it was already approved, you can unapprove the review.
    • Spam/Trash – Selecting either of these options will immediately remove the product review from your list of notifications and submit the change to the server.
Note: Made a mistake? You can either click UNDO in the confirmation message that briefly displays at the bottom of the screen, or log into your store/site on the web to gain access to spammed and trashed reviews.

Notifications Settings

Configure which notifications to receive in Notification Settings, including the custom Cha-ching! alert for new orders, which comes packaged with WooCommerce Android.

  1. Go to the Main screen.
  2. Open the hamburger menu, and select Settings. The Settings screen will appear.
  3. Disable or enable alerts, as you wish. Options will appear differently depending on which version of Android your device is running.
  • Android Oreo or later > Tap Manage Notifications to open the system channel settings.

  • Android Nougat or earlier > Configure all three settings in the Notifications section.

Note: Disabling a new order or product review notification will only prevent the alerts on your phone. The Notifications tab within the WooCommerce app will display all notifications regardless of alert settings.

Settings ↑ Back to top

Use Settings to:

  • View which store is connected to the app
  • Manage notification alerts
  • View and configure privacy settings
  • Read the terms of service
  • Learn more about WooCommerce and open source licenses

To open Settings:

  1. Go to the Main screen.
  2. Open the hamburger menu, and select Settings. The Settings screen will appear.
  3. Select whether to:
    • Manage notifications (explained in the Notifications section above)
    • Learn more about the app
    • Manage Privacy Settings

Settings is also where you log out of the app, as previously explained in the Log Out of Your Store section.

Help & Support ↑ Back to top

Find helpful resources or get in touch with one of our Happiness Engineers directly from the WooCommerce Android app.

To open the Help & Support screen:

  1. Go to the Main screen.
  2. Open the hamburger menu, and select Help & Support. The Help & Support screen will appear.
  3. Choose whether to:
    • Browse FAQs
    • Contact us at Support
    • View help desk tickets filed by this device
    • Set your contact email address
    • View, copy, and share the Application Log. Helpful for troubleshooting.

Contact Support ↑ Back to top

Get in touch with a Happiness Engineer directly from the WooCommerce Android app:

  1. Go to the Main screen.
  2. Open the hamburger menu, and select Help & Support. The Help & Support screen will appear.
  3. Tap Contact Support.
  4. Enter the email address for the associated store.
  5. Type your message, and send to our Support team.

Alternatively, you may also use the links provided below in Questions and Feedback to receive assistance.

My Tickets ↑ Back to top

  1. Go to the Main screen.
  2. Open the hamburger menu, and select Help & Support. The Help & Support screen will appear.
  3. Tap My Tickets.
  4. Select the ticket you wish to view.

Application Log ↑ Back to top

  1. Go to the Main screen.
  2. Open the hamburger menu, and select Help & Support. The Help & Support screen will appear.
  3. Tap Application Log. The Application Log screen will appear.
  4. From the Application Log screen, you can:
    • Copy: Tap the Copy icon, which will copy the log to the device clipboard, preparing you to paste the log into an application of your choice.
    • Share: Tap the Share icon, which will open a list of applications installed on your device that support sharing text.

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 can log in, but no stores are found? ↑ Back to top

Verify that your WordPress site has WooCommerce 3.5 or higher installed and Jetpack connected.

What is a hamburger menu? ↑ Back to top

A hamburger menu has three stacked dots or three stacked lines on a toolbar that open and expand to reveal more options.

Where can I submit a feature request? ↑ Back to top

The WooCommerce Android app is brand new and actively under development. Developers at Automattic have lots of features on the Roadmap and are excited about working with our community to build the best mobile eCommerce solution possible.

If you have an idea for improvement or a feature, please visit our Ideas Board and submit it at: WooCommerce Ideas: Mobile App.

Questions and Feedback ↑ Back to top

Have a question before you download the free app? Please fill out this pre-sales form.

Already downloaded and need some assistance? Get in touch with a Happiness Engineer via the Help Desk.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top