Support

App resources for iOS and Android users

Forums

If you run into issues while using your WordPress app, we encourage you to visit the forums for troubleshooting help and to view other discussions that might be helpful. In the forums, you can also provide feedback and requests for features and weigh in on future development.

For iOS users, visit the WordPress for iOS Forums.

For Android users, visit the WordPress for Android Forums.

FAQs

Here are some frequently asked questions:

WordPress for iOS

  1. Which version of WordPress does the App work with?
  2. Which devices will this work with?
  3. I get an “Unable to read the WordPress site on that URL” error message. What do I do ?
  4. I get a “Blog returned invalid data” error message. what do I do?
  5. I can’t login, I get a “Precondition Failed” or a “Forbidden” error message. What do I need to do?
  6. I can’t upload photos/videos, I get a “Failed” error message. What do I need to do?
  7. My blog is located in a folder, and resolves to http://example.com/blog. How do I add the blog?
  8. Can I adjust the size of photos uploaded from the app?
  9. I can save posts to local drafts but can’t figure out how to publish to the blog — what do I need to do?
  10. How do I delete a blog?
  11. I get an “XML-RPC Service are disabled on your blog”. How I can enable them on my blog?
  12. My Host Blocks XML-RPC Access! How do I fix that?
  13. Can I use SSL to encrypt the App communication?
  14. I’m in China and I can’t login, I get an SSL error. What do I need to do?
  15. How to set up set up Stats via Jetpack?
  16. I can’t connect to my self-hosted blog, what do I do?
  17. I get the error “Couldn’t Sync — Sorry, you cannot edit posts site.”
  18. How do I send in debug logs from the app?

WordPress for Android

  1. Which version of WordPress does the App work with?
  2. Which Android devices will this work with?
  3. How do I enable XML-RPC access to my blog?
  4. Can’t add my site to the app. What do I do?
  5. My Host Blocks XML-RPC Access! How do I fix that?
  6. Can I adjust the size of photos uploaded from the app?
  7. Can I use stats with a self-hosted blog?
  8. Adding a blog is taking a long time or times out. How do I fix that?
  9. Why do I get a “connection refused” error when on the stats tab?
  10. Can I use SSL to encrypt the App communication?

WordPress for iOS

  1. Which version of WordPress does the App work with?

    We make sure the app works with the current and two previous versions of WordPress. Earlier versions are not supported but may still work for most features.

  2. Which devices will this work with?

    The App works with any device that is running iOS version 7 or greater.

  3. I get an “Unable to read the WordPress site on that URL” error message. What do I do ?

    1. Ensure that you’ve typed in the URL correctly.
    2. If it’s correct, make sure XML-RPC services are enabled on the blog.
    3. Verify that xmlrpc.php is functioning properly:
      1. Locate your RSD meta tag by viewing-source on your blog. It will look similar to this: <link rel="EditURI" type="application/rsd+xml" title="RSD" href="http://example.com/xmlrpc.php?rsd" />
      2. Next, follow the link, http://example.com/xmlrpc.php?rsd, and make sure it resolved to an XML file. Locate the WordPress API item: http://example.com/xmlrpc.php.
      3. Lastly, load that apiLink value into your browser. If everything is setup correctly, you should see this message: “XML-RPC server accepts POST requests only.”
    4. Go to the W3C Markup Validator and type in the URL of your WordPress site. If you get a response such as “… one or more bytes that I cannot interpret as UTF-8″ that is most likely what is causing the app to have trouble with your site.
    5. Try with the default theme and with no active plug-in.(Trying it with the default theme and plugins disabled will help pin down where the problem is. If everything works then you go back and enable your theme and then try it again. If everything still works then you go back and activate each plugin one at a time until you find the one that is causing the breakage.)
    6. Turn on the ‘debug mode’, that enables extended log format, and check the log file. Instructions here.
  4. I get a “Blog returned invalid data” error message. what do I do?

    1. A common issue that can cause errors with the App is invalid characters.  The easiest way to check is to go to the W3C Markup Validator and type in the URL of your WordPress site.  If you get a response such as “… one or more bytes that I cannot interpret as UTF-8″ that is most likely what is causing the app to have trouble with your site.
    2. You can also try with the default theme and with no active plug-in.(Trying it with the default theme and plugins disabled will help pin down where the problem is. If everything works then you go back and enable your theme and then try it again. If everything still works then you go back and activate each plugin one at a time until you find the one that is causing the breakage.)
    3. You might be able to figure out what’s wrong by yourself by following the instructions here: http://wpiphonedev.wordpress.com/extra-debug/
  5. I can’t login, I get a “Precondition Failed” or a “Forbidden” error message. What do I need to do?

    If you receive a “Precondition Failed” that is most likely a mod_Security issue discussed in this WordPress Support Forum discussion.

    Check with your hosting provider or system administrator to see if permissions or other issues are causing the error.

  6. I can’t upload photos/videos, I get a “Failed” error message. What do I need to do?

    If you’re running WordPress 2.9.2 or later please be sure to add the following lines to your root .htaccess file:

    php_value memory_limit 128M
    php_value upload_max_filesize 128M
    php_value post_max_size 128M
    php_value max_execution_time 120

    Additional info here.

  7. My blog is located in a folder, and resolves to http://example.com/blog.  How do I add the blog?

    Type in the full URL when adding the blog, in this case, example.com/blog.

  8. Can I adjust the size of photos uploaded from the app?

    You can choose whether to have photos resized for faster uploading. You can choose between predefined dimensions (small/medium/large) or setting a custom resize dimension.

  9. I can save posts to local drafts but can’t figure out how to publish to the blog — what do I need to do?

    When you are ready to publish, change the status of the post (from the Settings screen) to “Published” and then tap “Save.”

  10. How do I delete a blog?

    1. Tap “Me” at the bottom of the screen
    2. Tap “Edit” in top left of the screen
    3. WordPress.com blogs can be hidden from the App view by using the toggle switch on the right.
    4. Self Hosted sites can be deleted by tapping the red “–” and then tap “Remove”.
  11. I get an “XML-RPC Service are disabled on your blog”. How I can enable them on my blog?

    Note: As of WordPress 3.5, XML-RPC is enabled by default. The following settings only apply to 3.4 or lower.

    1. Go to your blog and log in (/wp-admin).
    2. In the sidebar, open Settings and then select Writing.
    3. Under Remote Publishing, check the XML-RPC protocol checkbox.
    4. Click Save Changes at the bottom of the page.
  12. My Host Blocks XML-RPC Access! How do I fix that?

    1. Rename your xmlrpc.php file to something different, but only change it after the ‘xmlrpc’. Ex: xmlrpc_wp.php.
    2. Install this plugin.
    3. Read the installation instructions and activate it.
    4. Remove your blog from the app and add it back again.
  13. Can I use SSL to encrypt the App communication?

    Yes. On WordPress.com blogs, all communication (done over XML-RPC)  is by default going to use an encrypted connection via SSL.  For self-hosted WordPress, if you have SSL enabled, WordPress 2.6.1 or later supports pointing the RSD information at the “https” version of xmlrpc.php which creates an encrypted communication link with the App.

  14. I’m in China and I can’t login, I get an SSL error. What do I need to do?

    The app tried to connect to your blog using a secure connection (https) but apparently WordPress.com is being blocked in China over https connection. You can add the blog following the steps below:

    1. Tap the add blogs button.
    2. Tap on “Add self-hosted WordPress blog”.
    3. Insert the URL of your blog http://your-blog-name.wordpress.com/xmlrpc.php
    4. Insert your Credentials and tap “Save”.
  15. How to set up set up Stats via Jetpack?

    Jetpack is a plugin that connects to WordPress.com and enables awesome features like stats, powered by the WordPress.com cloud infrastructure. To view your self-hosted blog’s stats:

    1. Install the Jetpack plugin on your blog. To install, go to the Plugins > Add New in your dashboard, search for Jetpack, and click “Install Now”.
    2. Connect the plugin to a WordPress.com account. In the Jetpack tab in your dashboard click the “Connect to WordPress.com” button and follow the directions.
    3. In the app, enter the credentials to the WordPress.com account connected to the Jetpack plugin. You can do this when prompted on the Stats screen, or by tapping Settings > Your Blog > Configure Jetpack Stats.
  16. I can’t connect to my self-hosted blog, what do I do?

    If this guide to help you make the XMLRPC endpoint accessible didn’t help, the case might be that you’re running a plugin on your blog that is blocking access for apps to connect to your blog.

    We have a running list of WordPress plugins that can break your blog here: http://ios.forums.wordpress.org/topic/app-blocking-plugin-list?replies=1#post-5985

    If you’re running any of these plugins, please try and disable them to see if that fixes the problem.

    If your plugin is not on the list but does make your site unreachable, please let us know and we’ll add it. Feel free to nudge the developers of the respective plugins to fix the connectivity issues!

  17. I get the error “Couldn’t Sync — Sorry, you cannot edit posts site.”

    The reason you would get this error is most likely because of one of two reasons:

    1. The account you have on the site doesn’t have sufficient privileges. Your user role needs to be Author, Editor, or Administrator to be able to manage content in the app.
    2. You recently changed the URL associated with your blog in the app, moved your website elsewhere, or changed your CMS.

    Solution: make sure you have the sufficient privileges on the site, Author or higher. Make sure the blog URL in the app is correct by going to Settings and tap your blog to edit it.

  18. How do I send in debug logs from the app?

    1. Open the app.
    2. Click on the “Me” tab.
    3. If you see “Settings” in the top right tap on it, if not tap on the “Me” tab again and it’ll take you back to the blog list where you will see “Settings”.
    4. Click on “Support”.
    5. Enable “Extra Debug”.
    6. Exit out of the app and re-open it and try to perform the actions causing difficulty.
    7. Go back to the Support screen in Settings.
    8. Click on “Activity Logs”.
    9. Click on “Current.
    10. Tap the share button in the top right and select “Mail”.
    11. From here email the logs to the receipient of your choice.

WordPress for Android

  1. Which version of WordPress does the App work with?

    The App works with WordPress.com and WordPress 3.6 or higher.

  2. Which Android devices will this work with?

    The App will work on all phones that are running Android version 2.3 (Gingerbread) or higher.

  3. How do I enable XML-RPC access to my blog?

    Note: As of WordPress 3.5, you no longer need to enable XML-RPC access. While logged into your WordPress dashboard, select ‘Writing’ under the Settings tab on the left. Scroll down to ‘Remote Publishing’, then check the box next to ‘XML-RPC’ and save your changes.

  4. Can’t add my site to the app. What do I do?

    1. Ensure that you’ve typed in the URL correctly.
    2. If it’s correct, make sure XML-RPC services are enabled on the blog.
    3. Verify that xmlrpc.php is functioning properly:
      1. Locate your RSD meta tag by viewing-source on your blog. It will look similar to this: <link rel="EditURI" type="application/rsd+xml" title="RSD" href="http://example.com/xmlrpc.php?rsd" />
      2. Next, follow the link, http://example.com/xmlrpc.php?rsd, and make sure it resolved to an XML file. Locate the WordPress API item: http://example.com/xmlrpc.php.
      3. Lastly, load that apiLink value into your browser. If everything is setup correctly, you should see this message: “XML-RPC server accepts POST requests only.”
    4. Go to the W3C Markup Validator and type in the URL of your WordPress site. If you get a response such as “… one or more bytes that I cannot interpret as UTF-8″ that is most likely what is causing the app to have trouble with your site.
    5. Try with the default theme and with no active plug-in.(Trying it with the default theme and plugins disabled will help pin down where the problem is. If everything works then you go back and enable your theme and then try it again. If everything still works then you go back and activate each plugin one at a time until you find the one that is causing the breakage.)
    6. Turn on the ‘debug mode’, that enables extended log format, and check the log file. Instructions here.
  5. My Host Blocks XML-RPC Access! How do I fix that?

    1. Rename your xmlrpc.php file to something different, but only change it after the ‘xmlrpc’. Ex: xmlrpc_wp.php.
    2. Install this plugin.
    3. Read the installation instructions and activate it.
    4. Remove your blog from the app and add it back again.
  6. Can I adjust the size of photos uploaded from the app?

    When in the dashboard view of your blog, select ‘Settings’, then change the ‘Default image width’ setting to your desired width. You can also tap on an image in the post editor to set a custom size there as well.

  7. Can I use stats with a self-hosted blog?

    Yes! If you install Jetpack you can enable stats for your self-hosted blog. After installing the plugin, simply enter your new WordPress.com login after selecting the ‘Stats’ button in the app.

  8. Adding a blog is taking a long time or times out. How do I fix that?

    Adding a blog is dependent on the speed of your Internet connection, so if you have a very weak signal or a slow EDGE connection, try again when you are in 3G/4G or Wi-Fi mode.

  9. Why do I get a “connection refused” error when on the stats tab?

    If you’ve installed an ad blocker app such as AdFree Android, it will block your connection to stats.wordpress.com. You will need to edit the /system/etc/hosts file on your device and remove all entries that have stats.wordpress.com to get it working again.

  10. Can I use SSL to encrypt the App communication?

    Yes. On WordPress.com blogs, all communication (done over XML-RPC) is by default going to use an encrypted connection via SSL. For self-hosted WordPress, if you have SSL enabled, WordPress 2.6.1 or later supports pointing the RSD information at the “https” version of xmlrpc.php which creates an encrypted communication link with the App.