--- title: "Pages to Tabs" canonical: "https://support.appfire.com/space/CT/1561267409/Pages%20to%20Tabs" format: markdown --- > Macro (aura-html) ## Description The **Composition -** **Pages to Tabs** macro automatically renders as tabs all child pages of a specified parent page or specified pages from different spaces. In addition, you can: - Rename the tabs with custom names. - Position the tabs to the side or top. - Customize the design of the tabs. - Rearrange the order of the tabs. Refer to [this user guide page](https://appfire.atlassian.net/wiki/spaces/CTFCC/pages/1562739051) on how to use this macro. ![image](media://3652d658-5eb4-4c57-835e-d8070cda27c1) ## Macro editor ### Step 1: Source pages configuration The first step in the macro editor lets you configure the source pages for the tabs. ![pages_to_tabs_config.png](media://bf40a007-4d79-4208-bd78-c9946a9ad3a9) The following table provides details about the options in the first step of the macro editor. | **Name** | **Required** | **Default Value** | **Description** | | --- | --- | --- | --- | | **Source** | Yes | Parent page | Can be:
- **Parent page:** Lets you specify a parent page whose child pages you want to display as tabs. - **Page selector**: Lets you specify any pages you want to display as tabs. These pages can be located in different spaces. | | **Parent page**
Only if *Source *is set to *Parent page.* | Yes | | The parent page whose child pages you want to display as tabs.
You can enter keywords in the box to filter the pages by name. | | **Page selector**
Only if *Source *is set to *Page selector.* | Yes | N/A | The pages you want to display as tabs.
You can enter keywords in the box to filter the pages by name.
> ℹ️ Users can only view pages based on their permission level. | ### Step 2: Tab customizations The next step in the macro editor loads the specified pages as tabs. See the [https://appfire.atlassian.net/wiki/spaces/CTFCC/pages/1561267409/Pages+to+Tabs#Supported-tab-content](https://appfire.atlassian.net/wiki/spaces/CTFCC/pages/1561267409/Pages+to+Tabs#Supported-tab-content) section later on this page. ![pages_to_tabs_content.png](media://1029f6f4-5751-4217-b5a2-5b38251df7c1) You can: 1. Edit the tab titles. You cannot edit the tab content, as it automatically loads from the source pages. 2. Customize the design of the tabs. The expandable *Tabs customizations* panel on the left offers flexibility to match your design preferences, with options to adjust tabs' position, style, font size, and color. The following table provides details about the options in the *Tabs customizations *panel. | **Option** | **Description** | **Choices** | **Default** | | --- | --- | --- | --- | | **Tab position** | Specify where the tabs are positioned on the page. | - Top - Side | Top | | **Tab style** | Choose the visual theme for your tabs. | - Default - Blocks - Top highlight | Default | | **Tab font size** | Adjust the size of the text on the tabs. | - Small - Medium - Large | Small | | **Tabs color** | Customize the colors for active and inactive tabs. | First line: Active tab colors Second line: Inactive tab colors | Dark blue (Active tab) Blue (Inactive tab) | ## Supported tab content The following table lists which content or macros are supported within the [Pages to Tabs](https://appfire.atlassian.net/wiki/spaces/CTFCC/pages/1561267409) macro. Note that the list below might change in the future with new cloud releases. | **Content/Macro** | **Compatible** | **Notes** | | --- | --- | --- | | **Fonts**
- Normal text - Heading 1, 2, 3, 4, 5, 6 - Bold, italic, underline - Strikethrough - Code - Superscript, subscript - Text color | Yes | | | Text alignment | Yes | | | Lists
- Bullet - Numbered | Yes | | | Check List | No | Appear as bullet points. | | Links | Yes | All modes (URL, card, inline) will display as URL. | | Files & Images | Yes | - Base64 encoded PNG are not supported. - Invalid files or images appear with different styling. | | Mentions | Yes | - Displays as blue if it matches the logged-in user. - Displays as grey if it matches a user who is not logged in. - Clicking and hovering @mentions have no effect. | | Emojis | Yes | Some emojis are displayed as a blue star. (This is an Atlassian bug [CONFCLOUD-69848](https://jira.atlassian.com/browse/CONFCLOUD-69848?__hstc=72543820.4e76311f874131a99198a462418b615c.1678085111437.1678179259683.1678185128084.9&__hssc=72543820.70.1678185128084&__hsfp=179215543)) | | Expand | No | Content inside the macro will appear expanded. | | Table | Yes | The table border and cell color are not visible. | | Layouts / Sections | No | Will appear on top of each other. | | Quote | Yes | | | Code snippet | Yes | Content is visible, but Confluence styling, line numbering, color highlighting, and copy button are not available.
**Confluence's edit mode**
![image](media://306a845f-f3cd-4bbf-916a-08552659c1b9)
**Actual rendering in Pages2Tabs**
![image](media://3a769355-4186-4e3d-94c3-55e3eaa2b659) | | Panel
- Info - Note - Success - Warning - Error | Yes | Appears different compared to a normal page view. | | Status | Yes | Appears different compared to the normal page view. | | Divider | No | Appears as a short line. | | Date | Yes | Date is visible, but [lozenge](https://atlassian.design/components/lozenge/examples) is not. | | Status | Yes | Appears different compared to the normal page view. Some colors are not displayed correctly due to the Atlassian bug [CONFCLOUD-72377](https://jira.atlassian.com/browse/CONFCLOUD-72377?__hstc=72543820.4e76311f874131a99198a462418b615c.1678085111437.1678179259683.1678185128084.9&__hssc=72543820.70.1678185128084&__hsfp=179215543). | | Decision | Yes | Appears different compared to the normal page view. | | TOC | Yes | | | Excerpt include | Yes | Appears different compared to the normal page view. | | Create from a template | No | | | Page properties | Yes | | | Page properties report | Yes | | | **Jira Macros** | **Compatible** | **Notes** | | Jira issue macro - Single issue view | Yes | Appear as links. | | Jira issue macro - Table view | Yes | | | Jira issue macro - Total issue count view | Yes | | | Jira Charts (Pie Chart) | No | | | Jira Charts (Created vs Resolved) | No | | | Jira Charts (Two dimensional) | Yes | | | Jira Roadmap | Yes | All mode displays as links. | | Appfire macros | Compatible? | Notes | | Other Composition macros (such as nesting another Pages to Tabs macro) | No | | | Visibility
- Hide-If - Show-If | Yes | | | Others
- Security & Encryption - Scaffolding - Linking - Redirection - Salesforce & Confluence Connector | No | | | Others | Compatible? | Notes | | Other 3rd-party macros | No | | ## Related pages > Macro (contentbylabel)