- Installing Box Edit
- Opening and Editing Files
- Saving Files back to Box
- Locking/Unlocking files
- Uninstalling Box Edit
- Does Box Edit work on mobile browsers?
- Can Box Edit be deployed or used in a virtual environment?
- Does Box Edit support Limited User accounts?
- Does Box Edit support proxies?
- What happens if a collaborator opens and edits a document I'm editing?
- How is Box Edit different from Box Sync? Do they overlap at all?
- Can admins block their users from using Box Edit?
- How long are files opened by Box Edit stored on my computer?
- Where does Box Edit store edited files?
- How do I change the desktop program that Box Edit uses to open files?
- Collecting Box Edit Logs
- Network and Browser Issues
Using Box Edit
Installing Box Edit
Box Edit can be installed on any operating system supported by Box.
To install Box Edit on a single computer:
- 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.
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.
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.
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
Original Per User Uninstallation:
- Open Control Panel > Programs and Features
- 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.
- Open the Group Policy Management Console.
- Expand Forest, Domains, and the domain. Right-click Group Policy Objects, and then click New.
- In the New GPO dialog, in the Script Name field, type Box Edit per-user removal script. Click OK.
- Right-click Box Edit per-user removal script under Group Policy Objects, and then click Edit.
- In the Group Policy Management Editor window, expand User Configuration > Policies > Windows Settings, and click Scripts (Logon/Logoff).
- In the right pane, right-click Logon, and then click Properties.
- In the Logon Properties window, click Show Files...
- 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.
- Close Windows Explorer, and return to the Logon Properties window. Click Add...
- In the Add a Script dialog, in Script Name, click Browse..., and select the script you saved in the previous step. Click OK.
- In the Logon Properties window, click Apply, and then OK. Close the Group Policy Management Editor window.
- In the Group Policy Management Console, link the GPO to the domain or any organizational unit.
- Download the Box Edit installer.
- Open the installer and click Uninstall.
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?
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?
edit.boxlocalhost.comif your proxy is blocking Box Edit. Please review the DNS and Proxy configuration article.
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?
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
~/Library/Application Support/Box/Box Edit/Documents/