From 08e06663702f8791f10e2c167ef7c600ac055767 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 10 Jun 2025 09:57:34 -0700
Subject: [PATCH 1/5] add lists of identifiers and selectors
---
settings/custom-scripts.mdx | 101 +++++++++++++++++++++++++++++++-----
1 file changed, 87 insertions(+), 14 deletions(-)
diff --git a/settings/custom-scripts.mdx b/settings/custom-scripts.mdx
index cddbadac9..4939802f4 100644
--- a/settings/custom-scripts.mdx
+++ b/settings/custom-scripts.mdx
@@ -1,16 +1,16 @@
---
title: 'Custom Scripts'
-description: 'Fully customize your documentation with custom CSS & JS'
+description: 'Fully customize your documentation with custom CSS and JS'
icon: "code"
---
-Add custom CSS & JS to your documentation to fully customize the look and feel.
+Add custom CSS and JavScript to your documentation to fully customize the look and feel.
## Custom CSS
-Add any number of CSS files to your repository and the defined class names will be applied and available across all of your MDX files.
+Add CSS files to your repository and their defined class names will be applied and available in all of your `MDX` files.
-### Adding style.css
+### Adding `style.css`
For example, you can add the following `style.css` file to customize the styling of the navbar and footer.
@@ -25,27 +25,100 @@ footer {
}
```
-### Using Identifiers
+### Using identifiers and selectors
-Mintlify has a set of common identifiers to help you tag important elements of the UI. Some, but not all are listed in the following:
-
-`#topbar-cta-button` `#navbar` `#sidebar` `#content-area` `#table-of-contents`
+Mintlify has a set of common identifiers and selectors to help you tag important elements of the UI.
- Use inspect element to find references to elements you're looking to
- customize.
+ Use inspect element to find references to elements you're looking to customize.
+
+
+ - Banner: `banner`
+ - ChangelogFilters: `changelog-filters`
+ - ChangelogFiltersContent: `changelog-filters-content`
+ - ContentArea: `content-area`
+ - ContentContainer: `content-container`
+ - ContentSideLayout: `content-side-layout`
+ - Footer: `footer`
+ - Header: `header`
+ - NavBarTransition: `navbar-transition`
+ - NavigationItems: `navigation-items`
+ - Navbar: `navbar`
+ - PageContextMenu: `page-context-menu`
+ - PageContextMenuButton: `page-context-menu-button`
+ - PageTitle: `page-title`
+ - Pagination: `pagination`
+ - Panel: `panel`
+ - RequestExample: `request-example`
+ - ResponseExample: `response-example`
+ - SearchBarEntry: `search-bar-entry`
+ - SearchBarEntryMobile: `search-bar-entry-mobile`
+ - Sidebar: `sidebar`
+ - SidebarContent: `sidebar-content`
+ - TableOfContents: `table-of-contents`
+ - TableOfContentsContent: `table-of-contents-content`
+ - TableOfContentsLayout: `table-of-contents-layout`
+ - TopbarCtaButton: `topbar-cta-button`
+
+
+ - Accordion: `accordion`
+ - AccordionGroup: `accordion-group`
+ - Anchor: `nav-anchor`
+ - Anchors: `nav-anchors`
+ - APISection: `api-section`
+ - APISectionHeading: `api-section-heading`
+ - APISectionHeadingSubtitle: `api-section-heading-subtitle`
+ - APISectionHeadingTitle: `api-section-heading-title`
+ - Callout: `callout`
+ - Card: `card`
+ - CardGroup: `card-group`
+ - CodeBlock: `code-block`
+ - CodeGroup: `code-group`
+ - Content: `mdx-content`
+ - Expandable: `expandable`
+ - Eyebrow: `eyebrow`
+ - FeedbackToolbar: `feedback-toolbar`
+ - Field: `field`
+ - Frame: `frame`
+ - Icon: `icon`
+ - Link: `link`
+ - Logo: `nav-logo`
+ - Mermaid: `mermaid`
+ - MethodNavPill: `method-nav-pill`
+ - MethodPill: `method-pill`
+ - NavBarLink: `navbar-link`
+ - OptionDropdown: `option-dropdown`
+ - PaginationNext: `pagination-next`
+ - PaginationPrev: `pagination-prev`
+ - PaginationTitle: `pagination-title`
+ - Panel: `panel`
+ - SidebarGroup: `sidebar-group`
+ - SidebarTitle: `sidebar-title`
+ - Step: `step`
+ - Steps: `steps`
+ - Tab: `tab`
+ - Tabs: `tabs`
+ - TabsBar: `nav-tabs`
+ - TabsBarItem: `nav-tabs-item`
+ - TableOfContents: `toc`
+ - TableOfContentsItem: `toc-item`
+ - Tooltip: `tooltip`
+ - TryitButton: `tryit-button`
+ - Update: `update`
+
+
+
- References and the styling of common elements are subject to change as the
- platform evolves. Please use custom styling with caution.
+ References and the styling of common elements are subject to change as the platform evolves. Please use custom styling with caution.
-## Custom JS
+## Custom JavaScript
Custom JS allows you to add custom executable code globally. It is the equivalent of adding a `