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. How do I connect my site?
  2. What if I don’t have a site, or don’t remember my password?
  3. What is the Reader?
  4. How can I manage my site?
  5. How do I make a new Post?
  6. How do I make a new Page?
  7. Can I make my text fancy?
  8. How can I add an image?
  9. How do I edit image meta data?
  10. Where are the rest of the post options?
  11. Which version of WordPress does the App work with?
  12. Which devices will this work with?
  13. I get an “Unable to read the WordPress site on that URL” error message. What do I do ?
  14. I get a “Blog returned invalid data” error message. what do I do?
  15. I can’t login, I get a “Precondition Failed” or a “Forbidden” error message. What do I need to do?
  16. I can’t upload photos/videos, I get a “Failed” error message. What do I need to do?
  17. My blog is located in a folder, and resolves to http://example.com/blog. How do I add the blog?
  18. Can I adjust the size of photos uploaded from the app?
  19. I can save posts to local drafts but can’t figure out how to publish to the blog — what do I need to do?
  20. How do I delete a blog?
  21. I get an “XML-RPC Service are disabled on your blog”. How I can enable them on my blog?
  22. My Host Blocks XML-RPC Access! How do I fix that?
  23. Can I use SSL to encrypt the App communication?
  24. I’m in China and I can’t login, I get an SSL error. What do I need to do?
  25. How to set up set up Stats via Jetpack?
  26. I can’t connect to my self-hosted site, what do I do?
  27. I get the error “Couldn’t Sync — Sorry, you cannot edit posts site.”
  28. How do I send in debug logs from the app?

WordPress for Android

  1. How do I connect my site?
  2. What if I don’t have a site, or don’t remember my password?
  3. What is the Reader?
  4. How can I manage my site?
  5. How do I make a new Post?
  6. How do I make a new Page?
  7. Can I make my text fancy?
  8. How can I add an image?
  9. Where are the rest of the post options?
  10. Which version of WordPress does the App work with?
  11. Which Android devices will this work with?
  12. How do I enable XML-RPC access to my site?
  13. Can’t add my site to the app. What do I do?
  14. My Host Blocks XML-RPC Access! How do I fix that?
  15. Can I adjust the size of photos uploaded from the app?
  16. Can I use stats with a self-hosted site?
  17. Adding a site is taking a long time or times out. How do I fix that?
  18. Why do I get a “connection refused” error when on the stats tab?
  19. Can I use SSL to encrypt the App communication?

WordPress for iOS

Getting Started

  1. How do I connect my site? 

    To access a site hosted with WordPress.com, login with your WordPress.com credentials.

    To access a blog that is self-hosted, click on the link to ‘Add Self-Hosted Site’. For this option, enter the username, password and URL associated with that blog. If your blog is connected to Jetpack, you will also need to provide your WordPress.com login information to receive your Stats information. 

    At any point you can add additional blogs to your app by selecting the “My Sites” icon and clicking ‘Add a Site’. Each of these blogs can be managed independently through the app.

  2. What if I don’t have a site, or don’t remember my password? 

    From the login screen you can recover your WordPress.com password at the link just below the ‘Sign In’ button, or register a new WordPress.com account by using the link at the bottom of the screen. If you don’t see the links, try hiding your keyboard.

  3. What is the Reader? 

    If you have logged in with your WordPress.com username and password, in addition to access to your blog, you will see your Reader through the app. Your Reader displays all the posts across all the blogs you follow in the order they were published, with the most recent content appearing at the top. You’ll see an excerpt of the introduction to each post and the first image in the post.You can also add blogs to your Reader, search and sort by tags and much more! All of this can be done by selecting the icon in the upper right corner of the screen.
    ios reader

  4. How can I manage my site? 

    To manage your site, select the “My Sites” icon, and choose the site you are ready to manage. This screen is your iOS Dashboard for that site. From here you will have the ability to add or edit Posts, Pages and Comments. You will also have Admin access for any site you are an Admin of. This includes Stats for Jetpack and WordPress.com sites, the ability to view the site, edit general site settings or access the Admin panel in a browser window.
    ios my sites

  5. How do I make a new Post? 

    You can post at any time by selecting the icon in the bottom navigation bar. This will create a post on the last selected site, but you can change which site it publishes to by selecting the drop down in top navigation bar. You can also create a post by selecting ‘Posts’ from your site’s iOS Dashboard, and then the ‘+’ icon in the upper right corner. You can edit any post by select it from the ‘Posts’ screen.

  6. How do I make a new Page? 

    You can create a page by selecting ‘Pages’ from your site’s iOS Dashboard, and then the ‘+’ icon in the upper right corner. You can edit any page by select it from the ‘Posts’ screen.

  7. Can I make my text fancy? 

    While working in a Post or Page, you can add rich text inline using the buttons just above the keyboard. The default styles include bold, italics, strikethrough, hyperlink, unordered and ordered list, and blockquote. You can also toggle to the raw HTML if you’d like to add more robust styles in the code.
    rich text

  8. How can I add an image? 

    To add an image, tap the icon just above the keyboard. You may get a question to “Allow” the app to access your photos (click “Ok”). At this time, you can only upload images via the App, not video or through the media library.
    style toolbar

  9. How do I edit image meta data? 

    Once an image has fully uploaded, tap the image to bring up the “edit” overlay. Tap the image again to bring up the image details. Edit title, caption, alt text, alignment, link to, or size.
    edit image overlay 
    edit image details

  10. Where are the rest of the post options? 

    You can access additional post options, such as Save Draft, Categories, Featured Image, and more by selecting options at the top of the Post screen. The options button looks like a little cog.
    style toolbar

  11. 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.

  12. Which devices will this work with? 

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

  13. 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 site.
    3. Verify that xmlrpc.php is functioning properly:
      1. Locate your RSD meta tag by viewing-source on your site. 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.
  14. 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/
  15. 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.

  16. 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.

  17. 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.

  18. 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.

  19. 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.”

  20. 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”.
  21. 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.
  22. 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.
  23. Can I use SSL to encrypt the App communication? 

    Yes. On WordPress.com sites, 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.

  24. 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 site using a secure connection (https) but apparently WordPress.com is being blocked in China over https connection. You can add the site following the steps below:

    1. Tap the add sites button.
    2. Tap on “Add self-hosted WordPress site”.
    3. Insert the URL of your site http://your-blog-name.wordpress.com/xmlrpc.php
    4. Insert your Credentials and tap “Save”.
  25. 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 site’s stats:

    1. Install the Jetpack plugin on your site. 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 Site > Configure Jetpack Stats.
  26. I can’t connect to my self-hosted site, 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 site that is blocking access for apps to connect to your site.We have a running list of WordPress plugins that can break your site here: https://ios.forums.wordpress.org/topic/app-blocking-plugin-list?replies=1#post-5985If 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!

  27. 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 site 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 site URL in the app is correct by going to Settings and tap your site to edit it.

  28. 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 site 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. How do I connect my site? 

    To access a site hosted with WordPress.com, login with your WordPress.com credentials. 

     

    To access a site that is self-hosted, click on the link to ‘Add Self-Hosted Site’. For this option, enter the username, password and URL associated with that site. If your site is connected to Jetpack, you will also need to provide your WordPress.com login information to receive your Stats information. 

     

    At any point you can add additional sites to your app by selecting the icon, selecting ‘Settings’ and clicking ‘Add self-hosted site’. Each of these sites can be managed independently through the app. 

  2. What if I don’t have a site, or don’t remember my password? 

    From the login screen you can recover your WordPress.com password at the link just below the ‘Sign In’ button, or register a new WordPress.com account by using the link at the bottom of the screen. If you don’t see the links, try hiding your keyboard. 

  3. What is the Reader? 

    If you have logged in with your WordPress.com username and password, in addition to access to your blog, you will see your Reader through the app. Your Reader displays all the posts across all the blogs you follow in the order they were published, with the most recent content appearing at the top. You’ll see an excerpt of the introduction to each post and the first image in the post. You can access the Reader by selecting the icon and selecting Reader in the Android Dashboard.

    Here you can view recent posts, add blogs to your Reader, search and sort by tags and much more! All of this can be done by selecting the icon in the upper right corner of the screen.

  4. How can I manage my site? 

    To manage your site, select the icon. This will display the Android Dashboard where you can choose the site you are ready to manage at the top of the menu. To switch sites, click the site title displayed at the top of the list.In the Android Dashboard you will have the ability to add or edit Posts, Pages, Media and Comments. You can also update themes, add an image or video, view stats or go to your site! You may need to scroll in the menu to see all of the options.

  5. How do I make a new Post? 

    From the icon and with your site selected, you can create a post by selecting ‘Posts’ in the Android Dashboard, and then the ‘+’ icon in the upper right corner.You can edit any post by selecting it from the ‘Posts’ screen.

  6. How do I make a new Page? 

    From the icon and with your site selected, you can create a page by selecting ‘Pages’ in the Android Dashboard, and then the ‘+’ icon in the upper right corner.You can edit any page by select it from the ‘Pages’ screen.   

  7. Can I make my text fancy? 

    While working in a Post or Page, you can do basic text editing. You can select these features located directly above the keyboard to make changes to your post as you type, including bold, italics, underline, strikethrough, hyperlink, blockquote and the ‹more/› tag.

  8. How can I add an image? 

    With the Android App, you can add images directly from your device or images from your media library.From a Post or Page, select the icon. There you will have several options, including uploading from the device, choosing existing media and even creating a new gallery!
     

    The ‘Capture’ feature will activate your device’s camera and the ‘Select … from gallery’ option will allow you to choose media already catured on your device. You can also select existing media from your media library or create a gallery of existing media.

  9. Where are the rest of the post options? 

    You can access additional post options, such as Save Draft, Categories, Featured Image, and more by selecting options at the bottom of the Post screen.

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

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

  11. Which Android devices will this work with? 

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

  12. How do I enable XML-RPC access to my site? 

    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.

  13. 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 site. 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.
  14. 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 site from the app and add it back again.
  15. Can I adjust the size of photos uploaded from the app? 

    When in the dashboard view of your site, 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.

  16. Can I use stats with a self-hosted site? 

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

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

    Adding a site 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.

  18. 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.

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

    Yes. On WordPress.com sites, 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.