team-files-vs-confluence-1
Confluence Smart Links Explained
See how they work, where they fail with external files, and more secure, consistent management alternatives.
Read more: Confluence Smart Links Explained
untitled_Flux 2 Pro_2026-03-26_21-41-00
Jira SharePoint Integration
Discover how to sync files, automate folders, and enhance collaboration in Jira Cloud and Data Center.
Read more: Jira SharePoint Integration
Porto-pic
About us
From the start, our goal has been to remove the hidden friction that prevents teammates from collaborating easily on the files that matter most. We believe productivity is not about adding more tools but making the ones you already use work together seamlessly. Based in Porto, ikuTeam builds the invisible layer for the Atlassian ecosystem to dissolve file silos and help over a million users stay focused and move faster.
Read more: About us
team-files-vs-confluence-1

Confluence Smart Links Explained

See how they work, where they fail with external files, and more secure, consistent management alternatives.
Read more: Confluence Smart Links Explained
untitled_Flux 2 Pro_2026-03-26_21-41-00

Jira SharePoint Integration

Discover how to sync files, automate folders, and enhance collaboration in Jira Cloud and Data Center.
Read more: Jira SharePoint Integration

About us

From the start, our goal has been to remove the hidden friction that prevents teammates from collaborating easily on the files that matter most. We believe productivity is not about adding more tools but making the ones you already use work together seamlessly. Based in Porto, ikuTeam builds the invisible layer for the Atlassian ecosystem to dissolve file silos and help over a million users stay focused and move faster.
Read more: About us
Porto-pic
Product Documentation

Nov 19, 2026

2.2 Attaching files and folders to pages

Learn how to attach files and folders to your pages with the Google Drive Connector macro to share the knowledge with your team.


About the Google Drive Connector macro

Our macro allows you to attach 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 attach as many files and folders as you want per macro.

On this page, 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 inside Confluence.


Adding the macro to your page

Adding the Google Drive Connector macro to your pages is straightforward, with the / shortcut or from the insert menu (+) on the editor toolbar.


Using the / shortcut

Instructions:

  1. Enter the edit mode of the page where you want to attach files and folders.

  2. Place the cursor where you want the macro to appear.

  3. Type /Google Drive Connector and select Google Drive Connector from the list.

    Screenshot: Attaching files and folders to pages: Adding macro
  4. The Google Drive Connector dialog opens automatically. If it doesn’t, select the macro and click the “Edit” button.

  5. Browse your connected folders in the Google Drive Connector dialog. If you haven’t connected any, you can do so now. You can also connect more folders from the context menu as you would in the file manager.

  6. Click the checkbox to select the files and folders you want to attach. They will appear in the live preview pane on the right side. 

    Screenshot: Attaching files and folders to pages: Adding macro
  7. In Live Preview, you have an “Edit tag” button for files and folders. Select it to add a tag to any item, or to change or remove a tag you added earlier.

    Screenshot: Attaching files and folders to pages: Add Tag
  8. Optional: click the “Layout” tab to customize how attachments look on your page.

  9. Click the “Insert” button.

It's all done. You’ll be able to see your selections while you edit your page, but they’re not interactive now, as the editor limits the actions available.

While in edit mode, you can view your attachments and add more files and folders by clicking the “Edit” button on the macro again. You can preview your attached items, edit Microsoft Office and OpenOffice files, and browse your folders when you publish the page.

To ensure you’re selecting the correct file, you can preview your files as you would on the file manager. Click the name to open the full-screen preview or click the disclosure button on the live preview pane to preview the content, as you would on files and folders already attached.

Finding the macro with /

The / shortcut is the quickest way to add the macro. Type /Google Drive Connector, the name of the macro, and pick it from the list. Typing /attach finds it too.


Using the insert menu (+)

Instructions:

  1. Enter the edit mode of the page where you want to attach files and folders.

  2. Place the cursor where you want the macro to appear.

  3. Click the + (Insert elements) button on the editor toolbar.

    Screenshot: Attaching files and folders to pages: Insert items
  4. Start typing Google Drive Connector in the search field until you see it.

  5. Click the “Google Drive Connector” option.

  6. Browse your connected folders in the Google Drive Connector dialog. If you haven’t connected any, you can do so now. You can also connect more folders from the context menu as you would in the file manager.

  7. Click the checkbox to select the files and folders you want to attach. They will appear in the live preview pane on the right side. 

    Screenshot: Attaching files and folders to pages: Adding macro
  8. In Live Preview, you have an “Edit tag” button for files and folders. Select it to add a tag to any item, or to change or remove a tag you added earlier.

    Screenshot: Attaching files and folders to pages: Add Tag
  9. Optional: click the “Layout” tab to customize how attachments look on your page.

  10. Click the “Insert” button.

It's all done. You’ll be able to see your selections while you edit your page, but they’re not interactive now, as the editor limits the actions available.

While in edit mode, you can preview your attachments and add more files and folders by clicking the “Edit” button on the macro again. You can preview your attached items, edit Microsoft Office and OpenOffice files, and browse your folders when you publish the page.

To ensure you’re selecting the correct file, you can preview your files as you would on the file manager. Click the name to open the full-screen preview or click the disclosure button on the live preview pane to preview the content, as you would on files and folders already attached.


Customizing the layout

By default, the files and folders attached to Confluence pages use a regular header and appear in the collapsed view to use less space on the screen. It’s easy to preview the file by clicking the arrow to open the expanded view, which uses the width of the page and is 464px tall.

The Admin can set different defaults for new macros, and you can customize individual macros.

Screenshot: Attaching files and folders to pages: Customizing layout

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 Google Drive Connector dialog. You can preview the changes in the “Live Preview” panel. You’ll see the new layout applied to your page when you save the changes.

In “Live Preview“, you have an “Edit tag” button for files and folders. Select it to add a tag to any item, or to change or remove a tag you added earlier.

Screenshot: Attaching files and folders to pages: Add Tag

A tag is a short label that sits next to the file or folder. It gives an item context that its name alone does not carry, for example Approved, Draft, Invoices, or a client or team name.

Attachment header

Select the size for the header of the macro:

  • Regular: The standard size for the header of attached files and folders. It shows a big icon and additional details;

  • Compact: Uses a smaller icon and only indicates the name of the file or folder;

  • Hidden for files: Completely hides the file header and forces the expanded preview option. Moving the mouse over the file will show a compact header.

Preview width

Select the width for the preview:

  • Auto: The standard width for previews uses the available space;

  • Custom: Define a value for the width of the preview area.

Preview height

Select the height for the preview:

  • Regular: The standard height for previews (464px);

  • Custom: Define a value for the height of the preview area.

Preview default visibility

Select the behavior for the preview:

  • Collapsed: The standard option that hides the preview;

  • Expanded: Automatically shows the preview of files and folders. This option is required when selecting the “Hidden for files” header.


Sorting attached items

Use the “Sort” button on the macro to order the attached items by name, type, modified date or size, in ascending or descending order. Pick your options and click “Apply”. You can also sort the content of an attached folder from its actions.


Removing attached files and folders

You can remove specific files and folders attached to a macro at any moment.

Instructions:

  1. Enter the edit mode of the page

  2. Select the macro that you want to change

  3. Click the “Edit” button

    Screenshot: Attaching files and folders to pages: Macro edit
  4. The live preview pane lists all the attached files. Click the unlink button on the ones you want to remove from the macro.

    Screenshot: Attaching files and folders to pages: Detach
  5. Click the “Insert” button.

Your macro is updated.

If you make a mistake while removing attached files and folders, you can click the “Cancel” button to discard all changes.

The changes become permanent and can’t be undone when you click the “Insert” button. 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 and all the files and folders attached.

Screenshot: Attaching files and folders to pages: Delete macro

Instructions:

  1. Enter the edit mode of the page.

  2. Select the macro that you want to remove.

  3. 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.


Wrap up

Now you know how to attach files and folders to your pages and make changes to your macros.

If you still have questions about the topics covered on this page, visit our support portal and send them to us. Our team is always happy to help.