Skip to content

Commit cf69f66

Browse files
miaulalalabackportbot[bot]
authored andcommitted
docs(files): rewrite access_webgui for NC 33 with fresh screenshots
docs(files): rewrite access_webgui for NC 33 with fresh screenshots Rewrites the "Accessing your files using the Nextcloud Web interface" page to match the NC 33 UI: updates the left sidebar filter list to reflect the consolidated Shares entry, moves comments under the Activity tab, adds a Grid view section, and realigns every screenshot reference to what the automated Cypress spec actually captures. Replaces all nine referenced images with screenshots generated from a clean NC 33 (stable33) instance via the Cypress screenshot automation introduced in feat/screenshot-automation. AI-Assisted-By: Claude Sonnet 4.6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com> [skip ci]
1 parent f3b119f commit cf69f66

12 files changed

Lines changed: 116 additions & 106 deletions

β€Žuser_manual/files/access_webgui.rstβ€Ž

Lines changed: 116 additions & 106 deletions
Original file line numberDiff line numberDiff line change
@@ -8,176 +8,186 @@ has the option to disable these features, so if any of them are missing on your
88
system ask your server administrator.
99

1010
.. figure:: ../images/users-files.png
11-
:alt: The Files view screen.
11+
:alt: The Files app showing a list of files and folders.
1212

13-
Tagging files
14-
-------------
13+
Navigating your files
14+
---------------------
1515

16-
You can assign tags to files. To create tags, open a file to the Details view.
17-
Then type your tags. To enter more than one tag press the return key after
18-
creating each tag. All tags are system tags, and are shared by all users on your
19-
Nextcloud server.
16+
The left sidebar lets you switch between different views of your files. Click a
17+
folder name in the file list to open it, and use your browser's back button or
18+
the breadcrumb bar at the top of the file list to return to a previous level.
2019

21-
.. figure:: ../images/files_page-7.png
22-
:alt: Creating file tags.
20+
.. figure:: ../images/files_page-5.png
21+
:alt: The Files app left navigation panel.
2322

24-
Then use the Tags filter on the left sidebar to filter files by tags:
23+
The sidebar contains the following entries:
2524

26-
.. figure:: ../images/files_page-8.png
27-
:alt: Viewing file tags.
25+
All files
26+
The default view, showing every file and folder you have access to.
2827

29-
Comments
30-
--------
28+
Recent
29+
Files you have viewed or modified recently.
3130

32-
Use the Details view to add and read comments on any file or folder. Comments
33-
are visible to everyone who has access to the file:
31+
Favorites
32+
Files and folders you have starred.
3433

35-
.. figure:: ../images/file_menu_comments_2.png
36-
:alt: Creating and viewing comments.
34+
Shares
35+
Files shared with you, by you, or via a public link β€” all in one view.
3736

38-
Video player
39-
------------
37+
Tags
38+
Browse files by system tag.
4039

4140
You can play videos in Nextcloud with the Video Player app by simply clicking on
4241
the file. Video streaming by the native Nextcloud video player depends on your Web browser
4342
and the video format. If your Nextcloud administrator has enabled video
4443
streaming, and it doesn't work in your Web browser, it may be a browser issue. See https://developer.mozilla.org/en-US/docs/Web/HTML/Supported_media_formats#Browser_compatibility for supported multimedia formats in Web browsers.
4544

46-
.. figure:: ../images/video_player_2.png
47-
:alt: Watching a movie.
45+
When you navigate into a folder, a breadcrumb trail appears at the top of the
46+
file list so you can jump back to any parent folder with a single click:
47+
48+
.. figure:: ../images/files_page-6.png
49+
:alt: Breadcrumb navigation inside a subfolder.
4850

4951
File controls
5052
-------------
5153

52-
Nextcloud can display thumbnail previews for various file types, such as images, audio files, and text files.
53-
The specific types supported are up to the server administrator.
54-
Hover your cursor over a file or folder to expose the controls for the following operations:
54+
Nextcloud displays thumbnail previews for images, text files, and other
55+
supported types β€” the exact list depends on your server configuration.
5556

56-
Favorites
57-
Click the star to the left of the file icon to mark it as a favorite:
57+
Each file and folder row has a three-dot action menu button. Click it to
58+
rename, move, copy, download, delete, or mark the item as a favorite.
59+
Files that have been marked as a favorite display a star icon:
5860

5961
.. figure:: ../images/files_page-1.png
6062
:alt: Marking Favorite files.
6163

62-
You can also quickly find all of your favorites with the Favorites filter on the left
63-
sidebar.
64+
.. note:: You can quickly find all your favorites using the **Favorites**
65+
entry in the left sidebar.
6466

6567
Overflow Menu
6668
The Overflow menu (three dots) displays file details, and allows you to
6769
rename, download, or delete files:
6870

69-
.. figure:: ../images/files_page-3.png
70-
:alt: Overflow menu.
71-
72-
The Details view shows Activities, Sharing, and Versions information:
71+
Select **Details** from the three-dot action menu to open the details sidebar. The sidebar
72+
shows information about the selected file and provides tabbed access to its
73+
activity history, sharing options, and version history:
7374

7475
.. figure:: ../images/files_page-4.png
75-
:alt: Details screen.
76+
:alt: The details sidebar showing file information and tabs.
7677

77-
The **Settings** gear icon at the lower left allows you to show or hide hidden
78-
files in your Nextcloud Web interface. These are also called dotfiles, because
79-
they are prefixed with a dot, e.g. ``.mailfile``. The dot tells your operating
80-
system to hide these files in your file browsers, unless you choose to display
81-
them. Usually these are configuration files, so having the option to hide them
82-
reduces clutter.
78+
Activity and comments
79+
---------------------
8380

84-
.. figure:: ../images/hidden_files.png
85-
:alt: Hiding or displaying hidden files.
81+
The **Activity** tab in the details sidebar shows a chronological log of
82+
changes to the file β€” uploads, edits, shares, and comments. You can leave
83+
a comment directly in this tab; comments are visible to everyone who has
84+
access to the file:
8685

87-
Previewing files
88-
----------------
86+
.. figure:: ../images/file_menu_comments_2.png
87+
:alt: The Activity tab showing file history and a comment field.
8988

90-
You can display uncompressed text files, OpenDocument files, videos, and image
91-
files in the Nextcloud embedded viewers by clicking on the file name. There may
92-
be other file types you can preview if your Nextcloud administrator has enabled
93-
them. If Nextcloud cannot display a file, it starts a download process and
94-
downloads the file to your computer.
89+
Searching and filtering
90+
-----------------------
9591

96-
Navigating inside your Nextcloud
97-
--------------------------------
92+
Use the search bar at the top of the page to find files by name across all your
93+
files, or type in the search field inside the left sidebar to filter the current
94+
view:
9895

99-
Navigating through folders in Nextcloud is as simple as clicking on a folder to
100-
open it and using the back button on your browser to move to a previous level.
101-
Nextcloud also provides a navigation bar at the top of the Files page for quick
102-
navigation.
96+
.. figure:: ../images/files_page-7.png
97+
:alt: The search field with a search term entered.
10398

104-
Sharing status icons
105-
--------------------
99+
Grid view
100+
---------
106101

107-
Any folder that has been shared is marked with the ``Shared`` overlay icon.
108-
Public link shares are marked with a chain link. Unshared folders are not marked:
102+
The Files app defaults to a list view. Click the grid toggle button at the
103+
top-right of the file list to switch to a thumbnail grid, which is useful for
104+
browsing image folders:
109105

110-
.. figure:: ../images/files_page-5.png
111-
:alt: Share status icons.
106+
.. figure:: ../images/files_page-8.png
107+
:alt: Files displayed in thumbnail grid view.
112108

113-
Creating or uploading files and directories
114-
-------------------------------------------
109+
Click the button again to return to the list view.
115110

116-
Upload or create new files or folders directly in a Nextcloud folder by clicking
117-
on the *New* button in the Files app:
111+
Uploading and creating files
112+
----------------------------
118113

119-
.. figure:: ../images/files_page-6.png
120-
:alt: The New file/folder/upload menu.
114+
Click the **+** button near the top of the file list to upload files from your
115+
computer or create new items in the current folder:
116+
117+
.. figure:: ../images/files_page-1.png
118+
:alt: The New file and upload menu.
121119

122-
The *New* button provides the following options:
120+
The menu offers the following options:
123121

124-
Up arrow
125-
Upload files from your computer into Nextcloud. You can also upload files by
126-
dragging and dropping them from your file manager.
122+
Upload file
123+
Opens a file picker to upload one or more files from your computer. You can
124+
also drag and drop files directly from your file manager onto the file list.
127125

128-
Text file
129-
Creates a new text file and adds the file to your current folder.
126+
Upload folder
127+
Uploads an entire folder, preserving its structure.
130128

131-
Folder
132-
Creates a new folder in the current folder.
129+
New folder
130+
Creates a new empty folder in the current location.
131+
132+
New document / New spreadsheet / New presentation
133+
Creates a new file using the built-in Nextcloud Text or Office editor,
134+
if enabled by your administrator.
133135

134136
Selecting files or folders
135137
--------------------------
136138

137-
You can select one or more files or folders by clicking on their checkboxes. To
138-
select all files in the current directory, click on the checkbox located at the
139-
top of the files listing.
139+
Click the checkbox to the left of a file or folder to select it. To select all
140+
items in the current folder, click the checkbox in the column header.
141+
142+
With one or more items selected, action buttons appear at the top of the list.
143+
You can delete or download all selected items at once. Downloading multiple items
144+
produces a ZIP archive.
140145

141-
When you select multiple files, you can delete all of them, or download them as
142-
a ZIP file by using the ``Delete`` or ``Download`` buttons that appear at the
143-
top.
146+
.. figure:: ../images/files_page-9.png
147+
:alt: Multiple files selected with the bulk action bar visible.
144148

145-
.. note:: If the ``Download`` button is not visible, the administrator has
149+
.. note:: If the **Download** button is not visible, your administrator has
146150
disabled this feature.
147151

148-
Filtering the files view
149-
------------------------
152+
Sharing status icons
153+
--------------------
150154

151-
The left sidebar on the Files page contains several filters for quickly sorting
152-
and managing your files.
155+
Folders and files that have been shared display a **Shared** badge on their
156+
thumbnail or icon. Items shared via a public link also show a chain-link icon.
157+
Items that are not shared have no additional indicator.
153158

154-
All files
155-
The default view; displays all files that you have access to.
159+
.. figure:: ../images/files_sharing_status.png
160+
:alt: File list showing a shared folder, a public-link-shared file, and unshared items.
156161

157-
Favorites
158-
Files or folders marked with the yellow star.
162+
See :doc:`sharing` for instructions on creating and managing shares.
159163

160-
Shared with you
161-
Displays all files shared with you by another user or group.
164+
Moving files
165+
------------
162166

163-
Shared with others
164-
Displays all files that you have shared with other users or groups.
167+
Drag any file or folder and drop it onto a destination folder to move it.
168+
You can also use **Move or copy** from the three-dot action menu to move or copy
169+
items to a folder you choose from a picker dialog.
165170

166-
Shared by link
167-
Displays all files that are shared by you via public link.
171+
Previewing files
172+
----------------
168173

169-
External Storage (optional)
170-
Files that you have access to on external storage devices and services such
171-
as Amazon S3, SMB/CIFS, FTP…
174+
Click a file name to open a preview directly in Nextcloud. Supported formats
175+
include images, plain text, PDF, and β€” depending on your server β€” office
176+
documents and audio files. If Nextcloud cannot preview a file format, it
177+
downloads the file to your computer instead.
172178

173-
Moving files
179+
Video player
174180
------------
175181

176-
You can move files and folders by dragging and dropping them into any directory.
182+
You can play videos directly in Nextcloud by clicking the file. Playback
183+
depends on your browser and the video codec. See
184+
`MDN: Supported media formats <https://developer.mozilla.org/en-US/docs/Web/HTML/Supported_media_formats#Browser_compatibility>`_
185+
for a compatibility reference.
177186

178-
Creating or connecting to a Federation Share link
179-
-------------------------------------------------
187+
Connecting to a Federation Share
188+
---------------------------------
180189

181-
Federated Cloud Sharing allows you to mount file shares from remote Nextcloud
182-
servers, and manage them just like a local share. See :doc:`federated_cloud_sharing`
183-
to learn to how to create and connect to new Federated Cloud shares.
190+
Federated Cloud Sharing lets you mount file shares from remote Nextcloud
191+
servers and manage them just like local shares. See
192+
:doc:`federated_cloud_sharing` to learn how to create and connect to
193+
Federated Cloud shares.
-1.96 KB
Loading
41.5 KB
Loading
2.7 KB
Loading
-23.5 KB
Loading
-5.83 KB
Loading
-18.3 KB
Loading
-136 KB
Loading
43.3 KB
Loading
51.2 KB
Loading

0 commit comments

Comments
Β (0)