Showing results for 
Search instead for 
Do you mean 
The blueprint for the future of work
Register today!
Attend BoxWorks
Desktop, meet cloud.
Box Drive is the easiest and fastest way to connect to the cloud — without changing the way you work.
View resources

Editing Files with Box Edit

by ‎07-12-2016 03:34 PM - edited ‎07-07-2017 10:03 AM (17,319 Views)

Box Edit is an add-on feature that allows you to open and edit files stored in Box. Designed for all file types, browsers, and platforms, Box Edit uses the default application installed on your computer to open and edit files: Docx files open in Microsoft Word, PPTx files open in Microsoft PowerPoint, Xlsx files open in Excel, and so forth.

Note: New Box Experience

This page refers to the new Box experience. In Box, hover over a single file or folder with your mouse. If the item looks like the following image, you are in the right place.

 

Files and folders should look like this when you hover over them.Files and folders should look like this when you hover over them.

If the item does not look like the image above, visit one of the links below instead:

 

Using Box Edit

FAQs/Troubleshooting

 

Using Box Edit

 

Installing Box Edit

Box Edit can be installed on any operating system supported by Box.

To install Box Edit:

  • Download the Box Tools installer for your operating system here: https://www.box.com/box-for-devices/
  • Run the Box Tools installer and follow instruction prompts to install or update Box Edit on your computer.
  • Once you download and installed Box Edit, it will function in any browser supported by the Box web application.

Note: If you are using Internet Explorer, there are a few additional steps to configuring Box Edit. See the Box Edit Internet Explorer Configuration Guide for details. 

 

Box Device Trust:

In addition to Box Edit, the Box Tools installer includes Box Device trust, a component that checks the device status of enterprise users. If enabled by your administrator, Device Trust verifies that your device passes all necessary security checks required to log into your enterprise's Box account. It only performs checks that are enabled by the administrator of the enterprise -- no additional information about the device is collected or retained by Box.  If Device Trust is not enabled by a company's enterprise admin, the Box Device Trust module is never run and will not do anything. 

 

Device Trust is a feature currently in Beta. 

 

Opening and Editing Files

Once you have installed Box Edit, you can open and edit documents directly from Box. To open files with Box Edit:

  • Right-Click a file (or click the ellipses (...)) to open the More Options menu.
  • Click Open With... If there is more than one application with which you can open the file, you will have the option to select the appropriate application.
    box edit - 1

You can also open and edit documents after previewing them. To open files with Box Edit from the preview screen:

  • Click the file to open it in preview
  • Click Open. If there is more than one application with which you can open the file, you will have the option to select the appropriate application.

 

Saving Files to Box

After editing a file using Box Edit, simply save your changes in the native application. All changes will be saved back to Box automatically as a new version of the file. You will see a status display stating, File is saved to Box. <Filename> has been successfully saved to Box.

 

Note: When you save your file, be sure you hit Save in the native application and not Save As. If you select Save As, you will be creating a new copy of your file on your machine, and your changes will not be saved back to Box. 

 

Locking/Unlocking Files

If you are working on a file with other collaborators, be sure to lock files before opening them with Box Edit. This will prevent other users from making changes to documents that you are working on until you unlock the file. Locking files is not currently supported on our mobile applications.

 

Note: When you lock a file, it will show a lock icon, but you will still be able to edit it. When someone else locks a file, you will see a different lock icon, and you will not be able to modify the file unless you unlock it. 

 

From the Web Application 

To lock a file from the Box webapp:

  • Right-click a file (or click the ellipses (...)) to open the More Options menu.
  • Click Lock
  • Choose a duration for the lock. If you choose unlimited, the file will be locked until you unlock it manually. You can also choose to prevent users from downloading the file while you are editing it.
  • A lock icon to the left of the file's name will indicate that the file has been locked. If you use Box Sync, you will also see a lock icon over the file icon in your Box Sync folder. 

box edit - 2

 

 To unlock a file from the Box webapp:

  • Right-click a file (or click the ellipses (...)) to open the More Options menu.
  • Click Unlock

 

From Your Desktop With Box Sync

You can also lock and unlock files directly from your desktop using Box Sync.  

  • To lock a file, right click on the name of the file in your Box Sync folder, navigate to Box Sync, and select Lock. A lock icon will appear over the file icon to indicate that the file has been locked. 
  • When you lock a file from your desktop, a lock icon indicating that the file is locked will also appear to the left of the file's name in the web application.
  • Once you have finished your work, simply right click on the name of the locked file, navigate to Box Sync, and select Unlock. If you forget to do so, any other collaborator who has editing capabilities is also able to unlock the file. 

If you need to concurrently edit a document, you can use our Office Online integration to collaborate on Microsoft Office documents in real-time. Box Notes and Google Documents can also be edited with others in real-time. 

 

Uninstalling Box Edit

Windows:

Original Per User Uninstallation:

  1. Open Control Panel > Programs and Features
  2. Select Box Edit and click Uninstall.

Per-User Uninstallation Script (System Administrator Focus):

System administrators must remove per-user installations to move forward with machine-based deployments. Box provides a script to remove per-user Box Edit installations. The script verifies that the user has installed the per-user version of  Box Edit and if so, proceeds with the uninstallation.

 

The script can be run on any Windows server (manually or automatically). This script was created for the Windows Server 2008 R2 environment as that server is typically used for wide-scale deployments. However, this script also works for older environments.

 

Use the following procedure to uninstall per-user Box Edit installations.

  1. Open the Group Policy Management Console.
  2. Expand Forest, Domains, and the domain. Right-click Group Policy Objects, and then click New.
  3. In the New GPO dialog, in the Script Name field, type Box Edit per-user removal script. Click OK.
  4. Right-click Box Edit per-user removal script under Group Policy Objects, and then click Edit.
  5. In the Group Policy Management Editor window, expand User Configuration > Policies > Windows Settings, and click Scripts (Logon/Logoff).
  6. In the right pane, right-click Logon, and then click Properties.
  7. In the Logon Properties window, click Show Files...
  8. Download the removal script from https://app.box.com/s/wibflm4qm8sgahy09fek (click download in the upper-right corner), and save it to the folder that Show Files... opened. The script requires user credentials. If administrators want to uninstall the per-user Box Edit installation through Group Policy, they must assign it under User Configuration -- if they do it under Computer Configuration the script runs as a system.
  9. Close Windows Explorer, and return to the Logon Properties window. Click Add...
  10. In the Add a Script dialog, in Script Name, click Browse..., and select the script you saved in the previous step. Click OK.
  11. In the Logon Properties window, click Apply, and then OK. Close the Group Policy Management Editor window.
  12. In the Group Policy Management Console, link the GPO to the domain or any organizational unit.

 

Mac:

  1. Download the Box Edit installer.
  2. Open the installer and click Uninstall.

 

FAQs/Troubleshooting 

 

Does Box Edit work on mobile browsers?

Currently, Box Edit only works on web browsers and Box Embed. It is not available for mobile devices. However, Box OneCloud partners provide Box Edit-like functionality on mobile devices, such as CloudOn or QuickOffice.

 

Can Box Edit be deployed or used in a virtual environment?

Box Edit may work in a virtual environment, but there are certain known limitations. Be sure to use the MSI installer on VM/VDI. For more information, see Using Box in Virtual Environments.

 

Does Box Edit support Limited User accounts?

Yes, Box Edit can be installed with a limited user account (Mac & Windows).

 

Does Box Edit support proxies?

Yes, for both Windows and Mac. You may need to whitelist edit.boxlocalhost.com if your proxy is blocking Box Edit. Please review the DNS and Proxy configuration article.
 
Box Edit will use the proxy to access Box data and download documents. Please note that Box Edit also communicates with the local browser using the domain: edit.boxlocalhost.com
 
This domain points to the local system and in order for Box Edit to work, communications to this domain must go direct and not through a proxy.

 

What happens if a collaborator opens and edits a document I'm editing?

If you don't lock a file and another collaborator edits said file while you are also editing it, Box Edit creates two copies of the file on Box, so you can easily track changes separately and ensure content remains consistent. 

 

How is Box Edit different from Box Sync? Do they overlap at all?

Box Sync is designed to keep all your important content updated on your computer’s desktop, even when a colleague uploads a new version. You can access files and make edits directly from your desktop, and the updated versions are added to Box where the rest of your team can access them.

 

Box Edit provides the same benefits, but is designed for quick edits when you’re working from the Box web app. You can open, edit, and save a file without ever needing to leave Box – this add-on feature is ideal for content that’s not already synced to your desktop.

 

Can admins block their users from using Box Edit?

Yes, admins can disable this add-on feature for their users in the Box Admin console.

 

How long are files opened by Box Edit stored on my computer?

On Windows computers, files are stored locally for 7 days.

On Mac computers, they are stored locally for 21 days (3 weeks).

 

Once this time period has expired for a file, it will be deleted the next time Box Edit is launched (typically when a user restarts their computer). If you open a file through Box Edit, do not leave it open for longer than the storage periods listed above. Changes made to this file may be lost after this timeframe. To avoid running into this issue, close the after each editing session and reopen the file from the web application to begin a new set of edits.

 

Where does Box Edit store edited files?

Windows

Win 7:

%LocalAppData%\Box\Box Edit\Documents

Win XP:

%APPDATA%\Box\Box Edit\Documents

This would look like:

Win 7: C:\Users\username\AppData\Local\Box\Box Edit\Documents

Win XP: C:\Documents and Settings\username\Application Data\Box\Box Edit\Documents

Mac

~/Library/Application Support/Box/Box Edit/Documents/ 

 

How do I change the desktop program that Box Edit uses to open files? 

Box Edit opens files from Box.com according to the default program set on your computer. Box Edit downloads the file, reads the settings that your computer has in place for that file type and then launches the appropriate program.

 

If Box Edit is opening files in the wrong program for you, please follow the steps below to make sure that you have the correct program defaults set for you computer:

 

Collecting Box Edit Logs

If you are submitting a support request, you may be asked to submit the Box Edit logs from your computer as part of our investigation into your issue. Here's how to find your Box Edit logs on your computer and how to provide them to your support agent:

Mac (OS X): 

1. Navigate to the following folders on your computer: 

  • Macintosh HD/Users/[username]/Library/Logs/Box/Box Edit
  • Macintosh HD/Users/[username]/Library/Logs/Box/Box Local Com Server
2. Right-click on each folder above and use the "Compress" option to create a .zip file of each folder
3. Provide the .zip files to your support agent by using any of the following options:
  • attach the .zip files directly to your support case. You will need to be signed in to see your open support cases. 
  • upload the .zip files to your Box account and provide your support agent with a shared link to the .zip files
  • attach the .zip files to your email message when you reply to the agent

Note: You can navigate to the "Library" directory by entering the path "~/Library" into the "Go to Folder..." field. 

 

PC (Windows): 

Automatically finding the logs:

1. If Box Edit is running, you can use the "Save All Logs To A File" feature by right-clicking on the Box Edit icon in your system tray:

Note: you may also be asked to use the "Enable Debug Logging" feature and re-create the issue prior to using the "Save All Logs To A File" feature

 

2. After selecting "Save All Logs To A File", Box Edit will automatically create a .zip file on your Desktop containing the log files needed by the support agent

3. Provide the .zip file to your support agent by using any of the following options:

  • attach the .zip file directly to your support case. You will need to be signed in to see your open support cases. 
  • upload the .zip file to your Box account and provide your support agent with a shared link to the .zip file
  • attach the .zip file to your email message when you reply to the agent

 

Manually finding the logs:

You may be unable to use the "Save All Logs To A File" feature if Box Edit is not running properly. Here's how you can manually find and provide the log files to your support agent:

 

1. Navigate to the following folders on your computer: 

  • C:\Users\[username]\AppData\Local\Box\Box Edit\Logs
  • C:\Users\[username]\AppData\Local\Box\Box Local Com Server\Logs
  • C:\Program Files (x86)\Box\Box Local Com Server\Logs

Note: your computer may not have all of the folders listed above but do the following steps on any of the folders that do exist. 

2. Right-click on each of the above "Logs" folders and use the "Send to" > "Compressed (zipped) folder" option. 

3. Provide the .zip files to your support agent by using any of the following options:

  • attach the .zip files directly to your support case. You will need to be signed in to see your open support cases. 
  • upload the .zip files to your Box account and provide your support agent with a shared link to the .zip file
  • attach the .zip files to your email message when you reply to the agent
Note: You can navigate directly to the AppData\Local directory by entering the path: %LocalAppData% into the Windows search field.

 

Network and Browser Issues

When trying to click the pencil icon to edit a file in an Internet Explorer (IE) browser you may see one of the following messages:

  1. Your current browser mode does not support Box Edit
  2. Install Box Edit (even though it's already installed)

These may be caused by IE security settings. Please review problems and solutions below:

 

ActiveX Filtering:

  1. Symptom: Your current browser mode does not support Box Edit

  2. In Internet Explorer (IE), check if ActiveX Filtering is enabled in IE > Safety > ActiveX Filtering

  3. Disable it and refresh the page.

ActiveX Plugins:

  1. Symptom: Your current browser mode does not support Box Edit

  2. IE > Internet Options > Security > Custom level > Scroll down to the section: ActiveX controls and plug-ins > Run ActiveX controls and plug-ins > Enable

 

Enhanced Protected Mode in IE:

If Enhanced Protected Mode is enabled in IE you may see "Install Box Edit" even though you already have installed it. Internet Explorer may popup a small ribbon showing: 

This webpage wants to run 'Box Edit' which isn't compatible with Internet Explorer's enhanced security features. If you trust this site, you can disable Enhanced Protected Mode for this site and allow the control to run.

 

In the popup above, click Run Control to allow Box Edit to edit the page and add it to the preapproved ActiveX controls list and then click the Edit (pencil) icon again. If you accidentally selected "Don't Run" then you may still see the message to Install Box Edit. Clear your browser cache and cookies and history to reset this dialog so it shows again.

 

Another option is to add Box.com to the Trusted sites zone in Internet Explorer.

To do this, follow these steps:

  1. Login to Box.com in IE

  2. On the browser File menu, click Add this site to, and then click Trusted Sites Zone.

  3. In the Trusted sites dialog box, click Add to move Box to the list, and then click Close.

  4. Refresh the page to view the site from its new zone and confirm that Box Edit launches.

 

If you still see "Install Box Edit" please try disabling Enhanced Protected Mode in IE:

  1. On IE's menu, click Internet Options > Advanced tab

  2. Scroll down to Enable Enhanced Protected Mode and deselect the checkbox.

  3. Restart your IE browser for the changes to take effect.

  4. Confirm that Box Edit launches

 

Toolbars and Extensions:

  • Symptom: Install Box Edit appears even though it's installed

  • In IE, check if the Box Edit add-on is enabled. Note: You need to have your file/item in preview mode to see if the Box Edit add-on is enabled: IE > Manage Add-ons > Box Edit > Enabled

  • If you can't change your IE setting to Enabled, contact your IT department or Helpdesk and ask if they have a policy that is keeping it disabled.

 

App.box.com is blocked by a firewall: