This page is a welcome message for the Support Forums. We hope that you will find this a useful resource, as it is intended to be a "Quick-Start Manual" rather than full documentation. This introduction is designed to help you find your way around the forums and get started as quickly as possible. There is more information available at an expanded Codex article, Using the Support Forums.
Before you post, make sure you're posting about a self hosted WordPress.org site and NOT a WordPress.com site. If you're not sure, read WordPress.com vs WordPress.org.
These forums are meant for the core application, themes, and plugins that are distributed on wordpress.org. We do not support commercial themes or products.
Many of the questions that are posted in the forums have been posted many times before, and get the same answers each time. Before starting a new thread, please try searching the forums for an answer. Both the forums and the Codex have been indexed by Google, so if you can't find your answer with a forum search, it is worth typing it into Google too (e.g. Google for site:wordpress.org/support widget). If you do find a topic that describes a problem similar to yours, read it but do not post in that topic to ask for help.
The forum is split into sections, with each forum having its own one-line description on the front page. Please try to choose the most suitable section for your new topic, and please post your topic in only one section. Multi posting is frowned upon. Duplicate postings will be closed or deleted. Posting your own topic is smiled upon. Unless you are using the same version of WordPress on the same physical server hosted by the same hosts with the same plugins, theme, and configurations as the original poster, do not post in someone else's thread. Start your own topic. Choose your section from the forum front page. After following the appropriate link, start a new topic by clicking the "Add New »" button to the right of the section's title.
If you have a question about a specific theme or plugin, then we suggest visiting the homepage of the theme/plugin first and creating your topic on its support page. This has the effect of tagging the post with that item's name, making it more visible to the author and making it more clear what your post is about. You're more likely to get a response this way.
When you start a new topic, try to use an appropriate title. "Database error creating a new post" is a good title. "URGENT HELP PLS!!!" is not a good title. A good title can be the difference between getting help and not.
Tags are a great way to help others find related support requests, and to help developers keep track of specific features, so please be considerate of this when tagging your topic. For example, "REST API" would be a great tag for a topic about the REST API, while "rest" is common and largely unrelated English word and therefore not a great tag choice. Please also avoid very general tags, like "WordPress" and "problem," as we generally assume you're here because you have a problem with WordPress anyway. Searching first is a great way to see what tags are being used by others with similar problems.
If you have more than one tag, please separate them with commas.
Put down all the detail you can about your hosting environment, your WordPress install (plugins, themes, etc.), and the problem you are having. If you are seeing errors, copy them word for word into your post. It's best to include the full error than to summarize - sometimes wording is important. If you did something before you came across a problem, write down exactly what you did.
You can post links to screenshots to illustrate your issues, but don't use screenshots in place of a website link. Forum volunteers need a link to the webpage with the issue, to see a working (or broken) example of it.
If you are asking for help and your question relates to a specific site or page, please provide a link to it. It may help others when they are trying to help you.
Remember, though, the forum is not designed to be a link portal, so excessive linkage will be moderated, as might signatures or links with no associated question.
Be also aware, that links will not get removed any time later, unless in extreme circumstances.
Using your WordPress.org profile for advertisement in posts unrelated to your themes and plugins is discouraged. This includes signature links and URLs in display names.
The forums are here for providing users with a venue to get help with problems, this is why we intentionally do not have any sections for promoting plugins, themes, services and similar.
Please be kind and do not create topics with the intent of promoting any of the above, that's what social media is for.
Some sites contain content that is not suitable for a general audience or for viewing while at work. To avoid creating problems for anyone who is trying to help you, please add NSFW to the topic title of your post, as well as tag your post NSFW, as a warning if you think your site falls into this category. (Otherwise your post / links may be removed.)
Do not bump posts. Bumping a post to "the top" does not help your topic get noticed. The volunteers who try to answer questions look for those without replies first. If you bump a post, then it disappears from the 'No Replies' view.
Longer answer: We have a way of tracking down threads that have no answers, and we record those threads here. That list shows every thread that hasn't received a reply/comment. When your thread runs off the first page of the forum its likelihood of being found is reduced, but the 'no-replies' list gives your thread more chances to be found. Especially when some helpers use that list to prioritise over other answered threads. Your unanswered thread will still have the lifeline of the 'No Replies' list if it is no longer on the first page of the forum. When your thread has been answered it does not appear on the 'No Replies' list. It doesn't matter most of the time because the people replying are there to help you, but it matters when it's just you bumping your post. You may think you're helping your case by bumping your topic to the top of the list, but you are actually hurting yourself in the long-run. It's the long-run that you want to account for, as these volunteer-driven forums may struggle to provide you with quick support.
If you want help, do not bump.
Moderators will delete bumps they find. This is in order to help you get back into the No Replies listing, where you are more likely to get an answer.
When you need help with code, it helps us if you post it in the forums.
That said, we really need you to remember to keep your code enclosed in backticks (`) to stop it being parsed by the forum's software (which may also make it unreadable). Highlight your code in the editor and click on the "code" button to enclose your code in backticks. You don't have to mark each line, just the section (like you would for blockquotes).
If you don't do this, the odds are high that your post will be caught as spam by the automated tool, and we'll have to fix your post for you.
As for what constitutes a large excerpt, it's difficult to say. Certainly, if you're quoting an entire php/css/js file, put it on pastebin. For anything under 100 lines, we ask you use your best judgement. Do consider that you're asking people for free support, and it's much easier to read a pastebin/gist than a styled block of 150 lines of multi-indented code. Scrolling back and forth, as well as up and down, trying to unpick code via a cramped code box is a time-consuming activity that distracts from answering the actual questions.
Note: Anything you put in a forum topic or a pastebin is public. Anybody can see it. Don't post any passwords or private info there.
WordPress is free software and this is a free forum, so requesting paid help is discouraged. We also don't need bidding wars in the forums. If you post asking for paid help and you have posted some contact information, your thread will not be deleted but it will be closed and the contact information will be redacted.
Please do not post email addresses or contact URLs in the forums. Previously that was allowed but that has not been the case for years. The forums are not for people to harvest emails from or solicit being contacted.
Any thread that offers any service for money can be closed at any time. We are not against paid services but these forums are not the right place for them. Forum volunteers may advise you to seek professional support from WP Jobs. Please don't take this as a rude gesture. The main reason for this is that you may require more support than this forum can provide.
Please don't offer to work for hire in your replies on these forums. If you're going to help in the forums, help in the forums. If you're looking for work, please do so on WP Jobs instead. We're all for people making their living on WordPress, but we're trying to keep the free support forums ... free.
If you use a commercial theme or plugin and need support, please go to their official support channel. In order to be good stewards of the WordPress community, and encourage innovation and progress, we feel it's important to direct people to those official locations. Doing this will provide the developer with the income they need to make WordPress awesome.
Forum volunteers are also not given access to commercial products, so they would not know why your commercial theme or plugin is not working properly. This is one other reason why volunteers forward you to the commercial product's vendors. The vendors are responsible for supporting their commercial product.
If you leave the forums and can't find your thread when you get back, you can see a list of all the threads you've been involved in on your profile page. To view your profile click on the "View your profile" link in the upper right of the header at the top of every forum page.
Note: The "View your profile" link is only available after you log in. You might want to login now, if you haven't already.
If you know you posted but you can't find it, it may have gotten caught by our over-ambitious spam filter. If that happens, don't panic. One of the volunteers will get around to finding it and clearing it, usually within an hour. You can get caught as spam if you post too many times in succession, or if your posts are all the same (yep, it can check that), and a score of other potential causes. It happens to pretty much everyone at least once. Don't worry about it too much.
If you are here to help others, you can view a quick list of unanswered topics by using the "No Replies" link at the bottom of the front page. The "No Replies" filter is often used by folks to find questions to answer next. This is also a good reason why nobody should bump their topics. Bumping is discouraged and bumps may be deleted by the moderators.
If you're helping out, do your best to fully assist the person having the issues, and don't use your support as an excuse to promote your own site/themes/plugins. That behavior is frowned upon.
Similarly, we ask that you not demand payment, solicit work, or take the conversation to a private location. The point of helping out on the WordPress.org forums is to help out on the forums. Remember, we don't want this to happen. Leave something for the next person who has the same problem.
To report a bad (spam etc.) post, add a tag called 'modlook' to the thread. That feed is checked very regularly by the moderating team.
The modlook tag is only for reporting issues with the forum itself - abusing this tag in the hopes of attracting the attention of a moderator to your support question will not be viewed kindly. Don't put the modlook tag on your support question, put it on things like spam, or people using signatures in their posts, or duplicate threads. Things that a forum moderator should see and correct.
Note that it is not necessary to point out the actual problem, either with a post or with additional tags. Our moderators are smart. They'll scan the thread and find the problems themselves, and deal with it accordingly. Adding your own comments just gives them more to clean up, so please don't do it unless you feel the nature of the problem is very unclear like a double (or quadruple) post.
If you would like to discuss an aspect of the forum, or report a problem with the forum itself, use the #forums channel on slack.
Note that the channel is for discussing issues with the support forum itself, rather than for posting your problems with WordPress. It's primarily used by forum moderators and other regular volunteers for discussion of code and behavioral issues on the forums. While the list is public for anyone to join or read, it's intended use is for better communication among volunteers.
Posts are automatically closed after 12 months, if there are no new replies. We also reserve the right to close posts that are deemed non-productive to the community.
While many times non-productive posts are deleted, sometimes they have some relevance and instead are closed so the information remains, but discussion can no longer be furthered. This includes, but is not restricted to, posts on the following topics: Hosting recommendations (for or against), off topic conversations (i.e. non-WordPress), old/outdated topics, clearly resolved topics, excessive rudeness or antagonism, and requests for paid support.
Sometimes you might notice that your posts are closed as soon as you post them. This means that they have been caught in the spam queue, which is an automated process and sometimes catches posts by mistake. If this happens, a moderator then has to manually unspam your posts, so it may take a little while to be rectified. Your patience is appreciated!
Sometimes, when someone's having a bad day, their posts will be flagged so all posts must be approved by a moderator. This is considered a cool-down tactic, and isn't intended to be a bad thing. It just means your behavior caught our attention in a slightly negative way, and we want to keep an eye on you. If this happens, just be patient. We will review and approve your posts pretty quickly, or edit them and reply, pointing out what's wrong.
If, however, your actions escalate, you'll get banned. There's no one behavior to point at for this, but basically if you start lashing out, calling people names, making accusations, emailing people nasty messages, or challenging the authority of the moderators, you may end up banned. The basic rule of thumb is don't act like a bad person. You're an adult, you know how to behave. We expect you to, and if you don't, or can't, you will be banned.
Harassing anyone is not permitted, and you will be banned if you do this.
tl;dr: If your posts are being moderated or caught as spam, don't panic, just relax and maybe take a break. We'll still be here.
We reserve the right to delete topics or posts that are off-topic or detrimental to the community, however it is not the general policy to edit or delete forum posts unless they are spam, harassing, illegal, or outright abuse. We will not delete your post or remove your link just because an Internet search for a term brings up the forums before your actual URLs.
Users can edit a post for up to 60 minutes from the time of submission. After that, the post can only be edited by a moderator.
When a post is made and people contribute answers to an issue, that then becomes part of the community resource for others to benefit from and deleting posts removes this added value.
Forum topics will only be edited or deleted at the discretion of the moderators if they represent a valid legal, security, or safety concern.
Don’t post things you aren’t 100% okay with being public. We’ll delete them if we agree it’s a big enough deal, but ‘My SEO!’ is never an acceptable reason. (Remember too that other sites take archive copies of the forums, and we can do nothing to control that.)
Attention Plugin/Theme Authors: If users complain about your plugins, even if they are incorrect, we will not delete their posts. It's your responsibility to represent yourself well and educate them. Even if you are not running a business via your plugins, your reputation is impacted more by how you handle people's complaints versus how they treat you.
Accounts are not deleted, not even for obvious spammers, due to technical limitations of the system. If you don't want to use the forums anymore, log off and don't return. We'll miss you!
Usernames cannot be changed either. If you want to use a different username, then create the new username and stop using the old one.
There are many systems that your forum account hooks into: support forums, make blogs, core SVN, plugins SVN, theme SVN, meta SVN, and so on and so forth. It's a technical mess and we know it's annoying when you want to walk away, or regret the username cocopuff as not professional, but it's just what we've got right now.
As most of the moderators are volunteers, we ask that if you need moderator help for any reason, you post your request in the forum and tag it with the term "modlook" - someone will come take a look. Do not abuse that tag, or your account will be disabled.
If you use the modlook tag to bring attention to your topic you risk your account being disabled.
Following moderators 'home' and sending them email can be harassment, so please, before you hit send or fill in their contact form, remember that these are real human beings, and calling them names because they won't delete your post (or did delete one), is not cool.
AKA what not to do...
We need to keep the forums friendly, so, occasionally, topic content will be moderated. In severe cases, users may be blocked. This might mean anything from the light editing of some posts to complete removal of topics and deactivation of accounts. It should really go without saying, but the following are likely candidates for moderation or intervention:
And that's all. Enjoy your stay at the forums! Oh.. And, when you're done, please mark your topic as "Resolved". Thanks.