If you are having issues connecting to your site via FTP to upload files, follow the suggestions described in this article to resolve the difficulties you may be experiencing when attempting to connect to the remote host server.
If you are new to working with FTP and want more background information about what it is and how it works, read Understanding FTP.
Using the File Manager
The easiest way to upload files to your site is to use the File Manager from within the Admin Console to upload site files, because when you are logged in to the Admin Console, you are automatically connected via FTP to your site. To learn more about how to use the File Manager, read the section titled Using the File Manager to upload files in the article Uploading files with the File Manager and Dreamweaver.
Common factors that lead to connectivity issues
There are several reasons why you may be encountering issues when connecting via FTP:
- You are using a network (WiFi or LAN) that is behind a firewall
- Your machine has security or anti-virus software installed which is prohibiting the connection
- You have entered a user name and password that are not recognized by the system
If you are on a network with a firewall, (which is likely when working in a corporate office, an educational facility, a library, or a goverment agency) you may not be able to connect via FTP because the firewall prohibits file transfers (even though you've entered the correct credentials to log in). If you suspect this is the reason, try using a computer at home, or use a laptop in a different location with a network that is not restricted, to see if that resolves the issue. Also, if you are behind a firewall, verify that you have enabled the PASSIVE (PASV) mode option in the FTP client or Dreamweaver, because this can help (and is always recommended).
If you've installed security software or have anti-virus utilities running on your machine, it may be blocking the connection as your computer attempts to contact the remote server, because it sees the connection as a security risk. Check your Applications folder (Mac) or your Programs folder (Windows) to see if you have security software installed. If so, temporarily disable it and try connecting via FTP again, to see if that is the culprit.
Finally, it may be that you are using a different host, user name or password when you attempt to log in via FTP. If the credentials that you enter do not match the login information in the system for your site, the FTP connection will fail.
Also, double-check that you are not entering http:// in front of the domain name in the field when entering the host address.
The screenshots below illustrate the correct settings to use:
If you are using the Files panel in Dreamweaver to connect to your site, (which has a built-in FTP client), check the login information. Follow these steps:
- Select Site > Manage Sites.
- Click the Edit button in the Manage Sites dialog box.
- Click the Servers button and then select the Remote Server to view the connection details.
- Verify that your settings look similar to those shown below:
Note: The Quick Site Setup wizard should have set these credentials automatically (using your own site URL and your own email address). However, you may have changed the settings after defining your site, so double-check that the syntax is correct.
No matter which FTP client you use, take care not to enter the http:// prefix in the FTP Addresss (Host URL) field, and verify that you've selected the Use Passive FTP mode (in the More Options section of Dreamweaver, and in the Advanced tab of many FTP clients).
Issues attempting to upload templates
Unlike other site files, templates are a specific file type (.DWT) that correspond to the templates created in Dreamweaver. The templates for a site always reside in the Templates folder, which is located at the root level of the site. Since these files are specific to Dreamweaver, they are handled differently by the system. To create and upload new templates, choose one of the following methods:
- Log into the Admin Console. Choose Admin > Manage Templates. In the sidebar, click the option to Create a new template. Use the Design tab to type content and insert images using the WYSIWYG interface of the online editor. Alternatively, click the HTML tab and hand code the template contents. When you are finished, click Save and Publish. If desired, you can set the template as the default template for the site, which means it will be set as the template automatically when you choose Website > Web Pages > Create a new web page.
- Use an HTML editor, a text editor or Dreamweaver to design the template. Copy the HTML code. Log into the Admin Console. Choose Admin > Manage Templates. In the sidebar, click the option to Create a new template. Click the HTML tab and paste the code into the Template Content window. Scroll to the bottom and click Save and Publish.
- Launch Dreamweaver. Use the panel to log into your site. Choose File > New > Blank Template > HTML Template (and choose a CSS layout, if desired). Click Create. Choose File > Save to save the DWT file in the Templates folder at the root level of your site. Choose Insert > Template Objects > BC Editable Region to define the editable region on the template where the unique page content will appear. After you are finished designing the template, select the DWT file in the Files panel and click the Put button to upload the DWT file (and any dependent files, including CSS and image files) to the remote server. Then, log into the Admin Console and choose Admin > Manage Templates to edit the template (and if desired, set the template as the default template for the site).
Note: You cannot set a template as the default template for the site within the Dreamweaver authoring environment.
Attempts to upload a file are unsuccessful
There are also some situations when you can connect to the remote site (using Dreamweaver or a third-party FTP client) but you are unable to upload files. In these cases, there are several reasons why a file cannot be uploaded:
If the file uses a non-standard file extension, the system may not support the file type. See Supported file types for more details.
If the file is extremely large, it may exceed the size limitation of 150 MB per file. Try optimizing the file to reduce its size.
The third-party FTP client you are using may have a character limit that prevents you from entering your entire user name. Since the formula for the user name looks like this: my_domain_name.com/email@my_domain_name.com, the character limit may be exceeded for the user name field, and the FTP client is truncating the user name. There may also be other issues (such as the @ symbol occuring the the user name field) which cause some FTP clients to reject the user name. If this is the case, try using a different FTP client.
Permissions errors when attempting to connect to a site via FTP
If you are not the primary site administrator for your site, it may be that you do not have the permissions (privledges) set up for your user account that enable you to use the FTP feature, even though you've entered the correct user name, password and host information in the FTP connection fields.
- Verify that you have the permission enabled for the option: Can use FTP & File Manager for the site. Either contact your site administrator, or if you can access it, choose Admin > Manage Roles to see if you've been granted these permissions.
- Confirm that the site has not recently expired. If the trial site has expired, contact your site administrator for help.
Note: If you are the primary site administrator, you automatically have all of the permissions to perform administrative actions on the site, so this will not be an issue. However, it is up to you to control who does have these permissions, and they should only be granted to users that are trained in working with FTP and understand the responsibility and power of FTP (to protect the contents of the site from accidentally being deleted).