| Excerpt |
|---|
Learn how to attach files and folders to your pages with the Team Files macro to share the knowledge with your team. |
...
Our macro allows you to attach all kinds of files and entire folders to your pages using a particular view of the file manager. You can insert the macro on your pages as many times as you need , and you can attach as many files and folders as you want per macro.
| Widget Connector | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
On this page, we'll show you can check how to use the macro so you and your team can share the relevant files and folders in the right place, quickly building your one source of truth right inside Confluence.
...
Adding the macro to your page
Adding the Team Files macro to your pages is straightforward, with shortcuts the / shortcut or via the menu. You’ll get the same results, but there are some minor differences in the process“Insert items” menu.
...
Using the / shortcut
...
Instructions:
Enter the edit mode of the page where you want to attach files and folders.
Place the cursor where you want to the macro to appear.
Type /attach and select the Team Files app from the dropdown.
Click 
The Team Files dialog opens automatically. If it doesn’t, select the macro and click the “Edit” button.
Browse your connected folders in the Team Files dialog. If you haven’t connected any, you can do that so now. You can also connect more folders from the context menu as you would in the file manager.
Select the files and folders you want to attach by clicking the checkbox. You’ll see them appear on the live preview pane on the right side.
Optional: click the “Layout” tab to customize how attachments look on your page.
Click the “Insert” button.
...
| Info |
|---|
/ shortcut optionsUsing the / shortcut on the new editor is our preferred way to attach files and folders to pages. For your convenience, we We added some options that are easier to remember and type than the app name (which is the default term) for your convenience. You can add the Team Files macro to your page using any of the following options: /document, /attach, /teamfiles, /team files, /file, /folder, /sharepoint, /dropbox, /drive, /google drive, /box, /onedrive, /one drive, and /egnyte. |
...
Using the
...
“Insert items” menu
...
Instructions:
Enter the edit mode of the page where you want to attach files and folders.
Place the cursor where you want to the macro to appear.
Click the “Insert” “Insert items” menu on the toolbar (+) and then click “View more.”
Start typing Team Files in the search field until you see it. You can also look for it in the “External content,” “Media,” or “Visual & images” tab.
Click the “Team Files” option.
Browse your connected folders in the Team Files dialog. If you haven’t connected any, you can do that so now. You can also connect more folders from the context menu as you would in the file manager.
Select the files and folders you want to attach by clicking the checkbox. You’ll see them appear on the live preview pane on the right side.
Optional: click the “Layout” tab to customize how attachments look on your page.
Click the “Insert” button.
...
You can set different layout settings when attaching files and folders in a new macro or by editing existing macros by clicking the “Layout” tab in the Team Files dialog. You can preview the changes in the “Live Preview” panel. You’ll When you save the changes, you’ll see the new layout applied to your page when you save the changes.
Attachment header
Select the size for the header of the macro:
...
Enter the edit mode of the page
Select the macro you want to change
Click the edit button
Click and drag the handle on the left side of the item you want to reorder to the desired place.
Repeat as needed.
Click the “Save“ button when you’re done.
| Tip |
|---|
All done. The macro is updated. |
...
Removing attached files and folders
You can remove specific files and folders attached to a macro at any moment.
...
Instructions:
Enter the edit mode of the page
Select the macro that you want to change
Click the “Edit” button
The live preview pane lists all the attached files. Click the unlink button on the ones you want to remove from the macro.
Click the “Save” button.
...
If you make a mistake while removing attached files and folders, you can click the “Cancel” button to discard all changes.
| Note |
|---|
When The changes become permanent and undoable when you click the “Save” button, the changes become permanent and undoable. You can, however, attach the files and folders again, as removing them from the macro doesn’t delete them. |
...
Removing the macro
You can also remove the entire macro , removing and all the files and folders attached to it.
Instructions:
Enter the edit mode of the page.
Select the macro that you want to remove.
Click the “Remove” button.
It's all done. Your files and folders are safe and sound , but they are no longer attached to the page after you publish the changes.
...