Browse by Topic

File Access (WebDAV)

 
 

What can I do with WebDAV?

 
 

Choosing a WebDAV client

You will need a WebDAV client to connect to your store from your computer. We recommend CyberDuck, which prefills most of your store information. See Connecting to WebDAV with CyberDuck for more information. 

If you are using a WebDAV client other than CyberDuck, you can connect manually. See finding your login information below for the necessary steps.

 
 

Finding your Login Information

If you are not using Cyberduck as a WebDAV client, follow the instructions here to learn how to connect manually.

1. Go to Server Settings › File Access (WebDAV).

2. You will see the following login information:

  • WebDAV Path - the path (server) of your store, which will be your store's temporary URL followed by /dav
  • WebDAV Server Type - WebDAV (HTTPS/SSL) - the type of server used
  • WebDAV Username - this will be the store owner's email address
  • WebDAV Password - this will be a long string of random numbers and letters

WebDAV credentials page

If you download the connection files for  Cyberduck, most of this information is automatically entered. Cyberduck files do not include the password. You can also enter this information manually i.

Connection files

3. Add the information provided into the appropriate fields in your WebDAV client of choice. 

4. If you need to allow another user to access WebDAV, you can do so by adding or editing a user in Account Settings › Users. Scroll down near the bottom then check the box to enable WebDAV.

The WebDAV section for an individual user.

5. When logging into WebDAV as this user, use the new user's email address for the user name and the password in that user's WebDAV section found in Account Settings › Users. The Path and Server Type will be the same.

Connecting to WebDAV with CyberDuck

Cyberduck is a free WebDAV software client that allows you to access your store's files remotely. It is available for both Windows and Mac OS X. You will need to download and install Cyberduck before attempting the login instructions below.

 

Which version of Cyberduck should I download? Normally, we recommend downloading the most recent version. Occasionally, the most recent version may not work with BigCommerce. In these cases, uninstall and download a previous version.

 
 

Single-click Login

The Cyberduck connection file allows you to download a Duck file to your computer. Clicking on the file will open Cyberduck with your login information pre-populated, except for the password. Follow the steps below to download the Duck file.

 

Before following these instructions. Cyberduck must be downloaded and installed onto your computer.

1. Go to Server Settings › File Access (WebDAV).

2. Click Download next to Cyberduck Connection File.

Connection File

3. A file called [store-url].duck will be downloaded to your computer. Locate and double-click this file. When CyberDuck loads, enter your password (found in Server Settings › File Access (WebDAV)) when prompted.

.duck file type

 

Can't download the file? If you aren't the store owner, you need to have the Manage Settings user permission enabled for your user account under Users.

 
 

Connecting with Cyberduck Manually

If you don't wish to download the Cyberduck connection file, you can follow the steps listed below to connect to Cyberduck.

Finding Your Login Credentials

1. In your BigCommerce control panel, go to Server Settings › File Access (WebDAV).

2. You will see your WebDAV login information listed under the WebDAV tab.

User-added image

Connect with Cyberduck

1. Open Cyberduck.

User-added image

2. Click on Open Connection.

User-added image

3. Enter the login information from the BigCommerce control panel into Cyberduck/

  • Server - enter the WebDAV Path. The port 443 will fill itself in, and /dav will move to the Path field.
  • Username - this is the email address listed under WebDAV username.
  • Password - this is the WebDAV Password.

You may need to uncheck the Anonymous Login check box to input your username and password

User-added image

4. Click Connect. When the login is successful, you will see your store's folders.

User-added image

5. Once you are logged in, make sure you have set the following settings:
Under Edit Preferences under the General tab, ensure that the checkbox next to "Save Workspace" is unchecked.

User-added image

6. Next, click on the Transfers Tab. You want to ensure that Transfer Files is set to Open multiple connections.

User-added image

 

What can be done once connected? Refer to Connecting to WebDAV to learn more about what is accessible through WebDAV.

 
 

Folder Structure

The WebDAV folders that appear in the root directory (called dav) are listed below, as well as subfolders that are directly linked with a particular functionality in BigCommerce.

Note that WebDAV is case-sensitive. The folders listed below are given in their correct lowercase format.

Folders

  • content — store files not related to design or products (e.g. PDFs). See Uploading and Linking to a File in Your Store.
  • exports — download CSVs you have saved to the server
  • import_files — stores large CSVs you want to import from the server
  • product_downloads — store downloadable product files. After being uploaded, they are renamed and randomly assigned to subfolders of this folder.
    • import — upload the downloadable product files here. you can then create your product and select Use a file already on the server.
  • product_images — store product images; they are renamed and randomly assigned to subfolders of this folder.
    • configured_products — store files uploaded by customers when using a File Upload option. We recommend deleting these files once the order is complete.
    • import — store product images to be uploaded via CSV. See Importing Images. This folder may need to be created manually.
    • uploaded_images — Sync images with the Image Manager.
  • template* — store custom assets for your store's theme. All custom assets should be placed inside their designated subfolders. This folder will be blank by default.
  • mobile_template* — store custom assets for the mobile template. The layout is the same as the template folder.
* The template and mobile_template folders will only appear for stores using legacy Blueprint themes. Stores using Stencil themes will not have access to these folders. See Which Theme Platform do I have? for more information.
 
 

Notes on Using WebDAV

Root Directory Access

Although you can edit the contents of folders within the root directory (i.e. the dav folder), you cannot add or edit anything on the root directory itself. This is because all stores share the root directory.

Case Sensitivity

WebDAV is case-sensitive, so all references (including folders and files) must match exactly. Failure to do so will result in assets either not loading or being duplicated.

Blank Template Folder

The template folder will be empty be default, because all built-in template files are stored on the database, not WebDAV. Only customized files will actually appear here in WebDAV, since your store uses customized versions of the files instead of database versions.

Uploading Custom Theme Images

As explained above, your store's images are stored on a database instead of WebDAV. If you need to upload a custom theme image to the template/images folder, your store will begin pulling all theme images from WebDAV. This will cause your store to display broken images for any images that you have not already uploaded to WebDAV.

To prevent this from happening, follow the instructions provided in How do I upload a custom image?. This will ensure that your custom image is uploaded smoothly.

Was this article helpful?