After downloading and installing the app from your preferred app store and opening the app, click on the Log In button:
Enter Your Site Address
↑ Back to topWhere can I find my site address?
↑ Back to topIf you can visit your site on a browser, you already have the site address. You can get it from the address bar (the place where you enter your store name in your browser app).
This is the same address your customers will access to view your store on the web.
Type or copy that address and enter it in the app.
I am facing errors while trying to connect to my store.
↑ Back to topYou can follow the following steps if you are facing an error after entering your WooCommerce store address and tapping the “Continue” button.
- Make sure that you have a working internet connection. You can try opening the WooCommerce store address from your mobile device’s web browser to verify that you have a working internet connection.
- Your site needs to be up and running for the app to be able to access it. Sites under maintenance mode, or not yet launched, and sites exhibiting errors won’t work in the app.
- If you can open your store address in the web browser and you are still facing an error message on this screen, you can contact our support team by going to “Help > Contact support” in the app.
I want to create a new store.
↑ Back to topFind different options for starting your new store.
Now, there are two ways to log into the Woo Mobile app to manage your store. The first one is by using your WordPress.com account connected to Jetpack. The second is using the site credentials flow and your WP-Admin username and password. Let’s talk about each option separately below.
Note: Logging into the app via the Jetpack flow will give you more features like the ability to access multiple stores without logging out of the app, push notifications for new orders and reviews, Site visitor statistics and access to create Blaze campaigns.
Login with WordPress.com
↑ Back to topWhat is a WordPress.com account?
↑ Back to topThe WooCommerce Mobile App needs to create a connection to your website. This is important for WooCommerce stores as orders, and sales data are sent to your mobile devices. If you’re using the Jetpack plugin on your site or if you are using one of the WooCommerce Extensions that use the Jetpack Connection Package, the WooCommerce app will ask you to log in using the WordPress.com account that’s associated with Jetpack.
You can find more details in our What is a WordPress.com Account? guide.
Extensions Using Jetpack Connection
- Google for WooCommerce
- Jetpack Backup
- Jetpack Boost
- Jetpack Protect
- Jetpack Search
- Jetpack Social
- Jetpack VideoPress
- WooPayments
- WooCommerce Shipping
Where do I find my WordPress.com account?
↑ Back to topThere are two ways to find your WordPress.com email:
For self-hosted sites: You can find the account in the Jetpack section -> Dashboard -> Account connection.
For WordPress.com sites: Please check the https://wordpress.com/me page for your account email details.
If you have a WooCommerce.com account and are already logged into WordPress.com, please follow the steps mentioned here to connect your WordPress.com account to WooCommerce.com.
Enter WordPress.com Password
↑ Back to topI don’t remember my WordPress.com password
↑ Back to topIf you don’t remember your WordPress.com password, we recommend you log in using the magic link login option by tapping on the “Or log in with magic link” (iOS) / ”Log in with magic link” (Android) button at the bottom of the screen.
You will receive an email to your WordPress.com registered email address. You can tap on the link from the email to log in to the WooCommerce app.
Alternatively, you can tap on the “Reset your password” button to begin the password reset process. You can find more information about our password reset process in our Account Recovery support guide.
Open Mail to Find Login Link
↑ Back to topI requested a login link by email, but I can’t find the email. Why?
↑ Back to topPlease make sure you are checking the correct email address, as shown in the app. An email might also take a few minutes before it arrives.
If you are using a Gmail address, please look for the magic link email in the Updates folder as well as in the Spam folder.
To which email address is the login link sent?
↑ Back to topThe login link is emailed to the address that is used for your WordPress.com account.
Enter Store Credentials
↑ Back to topIf you prefer to use the WooCommerce app without installing the Jetpack plugin and if you are not using any of the plugins that use the Jetpack Connection, you can use the same credentials you use to sign in to WP-Admin to sign in to the mobile app as well.
To connect using your store credentials:
- Launch the app and tap “Login”
- Enter your store address and tap “Continue”
- If the app does not detect an active Jetpack connection, you’ll be asked to log in using your store credentials.
Where can I find my store credentials?
↑ Back to topStore credentials are the username and password you use to log into your WooCommerce store on the Web. If you forget your credentials, the guide below has various suggestions on how to regain your access:
https://wordpress.org/support/article/resetting-your-password/
The app says my username or password is wrong, but they are correct.
↑ Back to topThe WooCommerce app needs access to your site’s WordPress login page—which it normally expects /wp-login.php
— in order to authenticate using your site’s WP Admin username and password.
First, please make sure you can log in with the same username and password at the default WordPress login page by appending /wp-login.php
to your site address. Some hosting companies provided their customers with credentials to access their stores through their control panel but not through the default WordPress login page.
If you can’t log in via wp-login.php
, please contact your host for assistance.
I can’t log in because the application password is disabled. What is an application password?
↑ Back to topAn application password is a token (a series of characters) generated by a WordPress site that allows a third-party system or app to communicate with it securely via WordPress API without exposing your site credentials. For a WooCommerce store without Jetpack connected, the app requests an application password from your site to stay connected and sync your data.
If you see this error, a security plugin or a configuration on your site may be blocking the application password feature. You can deactivate the security plugin on your site and try logging in to the app again. If you still need help, please contact your host for assistance.
I am an Administrator/Shop Manager, but the app showed me a user role error.
↑ Back to topOnce the app authenticates your account, it has a process to verify your user role since it only allows an Administrator or Shop Manager to manage the store in the app.
If you see this error, here are some troubleshooting steps:
- Make sure your user role is either Administrator or Shop Manager on WP Admin -> Users -> Profile.
- If you use any security plugin that may block access to WordPress API, please deactivate it and try again.
- Try creating another account with the default Administrator or Shop Manager role if you use a plugin to edit your user role or capabilities.
I use a custom WP Admin or login page. Can I use the app?
↑ Back to topIf you fail to log in to the app due to a custom WP Admin or login page, the app will prompt you with an alternative to retry with the web browser in the app.
You will need to go through two other steps to log into your WP-Admin page and authorize the app to access it:
If you still fail to log in on the web view, please consider reverting to the default WP Admin or login page temporarily and try again. Some users will get a 404 error after trying to authorize access. In these cases, you would need to contact your host for assistance.
The app showed me the “The name of each application must be unique.” error.
↑ Back to topThis issue can happen when an application password is generated for the WooCommerce Mobile App, but the process is disrupted due to an unexpected error. When you log in to the app again, your site returns this error to the app because the application name must be unique.
To resolve this issue, please go to WP Admin -> Users -> Profile, scroll down to the Application Password section, and click the “Revoke” button on the application name that looks like one of these:
com.woocommerce.android.app
com.automattic.woocommerce.ios
I’m still having trouble logging in with my store credentials
↑ Back to topIn general, these are the common causes of login issues with store credentials:
- Custom WP Admin or WP Login page
- The application password feature is disabled
- WordPress API is disabled
- Security plugins or settings that blocked the app from authenticating your account programmatically
If you use any security plugin that does any of those mentioned above, it is worth deactivating it temporarily and try if you can log in to the app. You may also want to contact your host to confirm if the restrictions do not come from the server settings.
Alternatively, you may want to try connecting to the app using the Jetpack plugin. If you connect to the app with Jetpack, you can see visitor stats in the app, receive push notifications for orders, and manage multiple sites with only one login using your WordPress.com account.
If you choose to go that route, you can follow the instructions in the guide below to set up Jetpack:
https://woocommerce.com/document/jetpack-setup-instructions-for-the-woocommerce-mobile-app
Once the plugin is installed and connected to a WordPress.com account, after entering your site address to connect to the WooCommerce Mobile App, you’ll be asked to log in using the same WordPress.com account that was used to connect Jetpack.
Pick Store After Entering Password
↑ Back to topI’m logged in, but my store does not appear in the list of sites to select. Why?
↑ Back to topMake sure that you can access the store from the desktop using the WordPress.com account email that you used to log in to the WooCommerce Mobile App.
For a self-hosted site
If your site already has the WooCommerce and Jetpack plugin installed, please ensure that you have connected your WordPress.com account with the Jetpack plugin.
Please follow the following steps to check and connect Jetpack to your WordPress.com account:
- Access your store’s wp-admin page from a desktop. If you have the right “Role”, you can access the “wp-admin” page by entering the following URL in your desktop browser.
[yourstore.com]/wp-admin/ - Navigate to the Jetpack’s Dashboard page. You can find the Jetpack menu by checking the top left corner.
- Scroll down to the “Connections” section and check the “Account Connection”. It will look like the following if you haven’t connected your WordPress.com account.
- Tap on the “Connect your WordPress.com account” link and follow the instructions.
Once you have your WordPress.com account connected and authorized, you can log in to the app again, and you should be able to select your store.
No WooCommerce Store Found
↑ Back to topI’m logged in, but the app says it can’t find any WooCommerce stores. Why is this?
↑ Back to topIt 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.
Is Jetpack Required?
↑ Back to topWhat is Jetpack?
↑ Back to topJetpack is a WordPress plugin that 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. In the WooCommerce Mobile app, the Jetpack plugin is required to access the following features:
- Push notifications for new orders, reviews, etc.
- Site visitor statistics.
- The ability to manage multiple stores from within the app.
- The ability to create Blaze Campaigns
You can still connect your WooCommerce store to the WooCommerce Mobile app without Jetpack. Please refer to the Enter Store Credentials section for more details.
I tried installing Jetpack but got an error. What can I do?
↑ Back to topPlease get in touch with Jetpack support for assistance.
How do I connect my WordPress.com account to my site’s Jetpack?
↑ Back to topFor self-hosted sites
Please make sure that you can access the store using your WordPress.com account. You can do this by accessing your site’s wp-admin
from your desktop browser.
To connect your WordPress.com account with your site’s Jetpack, you can follow the steps here.
For WordPress.com site
For WordPress.com-hosted sites, the Jetpack connection will be done automatically.
Please make sure that you can access the store using your WordPress.com account. You can do this by accessing your site’s wp-admin
from your desktop browser. If you still face an error message on this screen, you can contact our support team by going to “Help > Contact support” in the app.
For an Administrator who is trying to give access to other users
↑ Back to topYou can check the Jetpack connection status of the invited users from the Users
page of wp-admin
.
If the invited user has a Jetpack connection established, you will see the green Jetpack logo at the end of the row. Please refer to the part highlighted using a red circle in the following screenshot.
If they do not already have their account connected to a WordPress.com account through Jetpack, you can refer to Jetpack’s Additional Users guide.
Not a WooCommerce Site
↑ Back to topYou need to have the WooCommerce plugin installed on your WordPress site to turn it into a WooCommerce store.
From mobile app
The following instructions will help you to install the WooCommerce plugin on your site from the mobile app.
iOS
- Start by tapping on the “Install WooCommerce” button from the error screen.
- You will be taken to the “WooCommerce Setup” screen. If asked to do so, kindly login using your WordPress.com account.
- Once you reach the WooCommerce plugin page, tap the “Install and Activate” button to start the installation process.
- Wait for the installation and activation to finish. After the mobile app verifies the WooCommerce installation, you will be automatically navigated inside the mobile app.
- If you face issues during the installation process, you can contact our support team by going to “Help > Contact support” in the app.
From desktop browser
Please follow the following steps to install WooCommerce plugin on your site.
- Access your store’s wp-admin page from a desktop. If you have the right “Role”, you can access the “wp-admin” page by entering the following URL in your desktop browser.
[yourstore.com]/wp-admin/ - From the menu on the left side, select “Plugins -> Add New”.
- Search for “WooCommerce” and click on “Install Now” to start the installation.
- Once installation finishes tap “Activate” and follow the instructions to set up your store.
Still experiencing issues?
↑ Back to topIf you’re using the Jetpack plugin to connect the app to your site, make sure that the Jetpack connection is active and working correctly. You can verify some known issues or try reconnecting your site.
If you’re still having difficulty, please fill out our contact form to reach our support team from within the app by going to Menu > Settings > Help & Support > Contact Support.