UT Drupal Kit Documentation
  • What is the UT Drupal Kit?
    • Default content types
    • Add-on content types
    • Taxonomy
    • Block types
    • Menus
    • Page display options
    • Users and Roles
    • Views
    • Site-wide announcement
    • Text formats and the rich text toolbar
    • Draft workflow
    • Configuration management
    • Theme
    • Bootstrap framework
    • Other functionality
  • Creating and managing content
    • How to sign in
      • EID sign-in
      • Non-EID sign-in
    • Building general-purpose content with Flex Page
      • Designing page layouts
        • Creating a new layout
      • Setting page options
        • Set page-specific metatags
        • Remove breadcrumb
        • Remove page title
        • Display page update timestamp
      • Adding content blocks
        • Available block types
      • Inline versus site-wide blocks
        • Creating inline blocks
        • Creating site-wide blocks
    • Creating Profiles
      • Individual Profile pages
      • Profile listings
        • Inline or site-wide listing?
        • Filtering listings by groups and tags
        • Selecting specific Profiles by name
        • “View in Directory” link
        • Toggle the email address display in Profile listings
    • Creating News
      • Individual News articles
      • News listings
      • News listings configuration
      • News article listing blocks
        • Inline or site-wide listing?
        • Filtering by category, tags, and “featured”
    • Creating Events
      • Individual events
        • Recurring events
        • Control image display
        • Summary and Body fields
        • Location field
        • “Event tags” and “Featured event”
        • Event status field
      • Event syndication on calendar.utexas.edu
      • Events listing page
        • Event listing page configuration
      • Event listing blocks
        • Inline or site-wide listing
        • Filtering by and tags, location and “featured”
      • Importing Events from other Drupal Kit sites
        • Locating events to be imported from other Drupal Kit sites
    • Managing page region content
      • Overview of page regions
      • Content recommendations for editable page regions
      • Quick edit of existing content using “Pencil” icon
      • Manage content region placement and page assignment
    • Managing site navigation
      • Working with page paths
        • Automatically generated paths
        • Customize a page path
      • Working with breadcrumbs
        • Customize the page breadcrumb
        • Remove the page breadcrumb
      • Working with links
        • Link to an external web page
        • Link to a page in your site
        • Link to an email address
        • Set a link to open in a new tab: link fields
        • Set a link to open in a new tab: rich text editor
        • Append an icon to a link: link fields
        • Append an icon to a link: rich text editor
        • Create links using the rich text editor
      • Working with menus
        • The main menu
        • Adding a page to navigation
        • Placing a menu within a page
        • How to edit menus and menu links
        • Types of menu links
        • Add icons to menu links
    • Working with media
      • What “files” and “media” mean in Drupal
      • The Media Library
      • How to create media
      • Removing media vs. deleting files
      • Disambiguation: “media” vs. “embedded content”
      • When to use an external file sharing service instead of uploading files?
    • Working with rich text editors
      • Embedding Qualtrics forms
      • Embedding media
        • Adding images and video with Media Library
        • Adding media from third-party providers
        • Manipulating media display
        • Other embeds that require <script> or <iframe> tags
      • How to add icons and buttons to links
      • Advanced HTML markup
        • Accordions
        • Inner Rail
        • Styling Tables
      • Styling HTML elements
        • Using the Styles dropdown
    • Other page types
      • Basic page
      • Creating additional content types
  • Configuring site behavior
    • Theme settings
      • Site Logo
        • Logo size recommendation
        • Display location of logo
        • Allowed file formats
      • Favicon manifest
      • Header regions
      • Parent entity text
      • Main menu alignment
    • Google Programmable Search Engine
      • Configure Google Programmable Search in a site
        • Add the ID to a site
      • Remove search altogether
      • Alternative: use Drupal search
    • Google Tag Manager/Google Analytics
      • Basic configuration
    • Permissions for content editing and site managing
      • Basic Configuration
    • Social media icons
      • Customize existing icons, or add additional social media icons
      • Accessibility guidelines
    • Social media share links
      • Configure social media platforms
      • Control where social sharing links display
      • Add social sharing links to a specific Flex Page
      • Add social sharing links to all pages of a certain type
  • Integrating external content
    • Instagram
      • Step 1: Set up a Professional account on Instagram
      • Step 2: Create an Instagram App
      • Step 3: Authorize your Instagram account to use this app
      • Step 4: Connect the Instagram app to your website
      • Step 5: Add Instagram content
    • University Events (Localist)
  • Managing site-wide announcements
    • Manage announcement permissions
    • Post a site announcement
    • Remove an active site announcement
    • Add additional icons
    • Add additional color schemes
  • Managing user accounts
    • Users permissions
  • Developing and extending code
    • Developers: Getting started
      • Concepts and tools
        • Composer
        • Version control
        • Hosting
        • Scaffolding
        • Build & deployment
        • Installation
      • Requirements
        • Server requirements
        • Composer
        • Version control
        • Hosting
      • Pantheon setup
        • Creating a new site
        • Integrating Enterprise Authentication
      • Non-Pantheon setup
        • Scaffold the codebase
      • Local development
        • Lando/Pantheon Localdev
        • Other local server environments
      • How to use settings.php
        • settings.site.php
        • settings.local.php
        • development.services.yml
    • Add-ons
      • Add-on architecture overview
      • Managing add-ons with Composer
        • Special cases: Add-ons as starter code
      • Managing user permissions for add-ons
      • Maintaining and extending add-ons
      • Profile add-on
        • Installing using Composer
        • Enabling functionality
        • Applying updates
        • Extending functionality
        • Profile permissions
      • News add-on
        • Installing using Composer
        • Enabling functionality
        • Applying updates
        • News permissions
      • Events add-on
        • Installing using Composer
        • Enabling functionality
        • Applying updates
        • Event permissions
    • The Forty Acres theme
      • Creating and customizing a sub-theme
        • Scaffold a sub-theme
        • Customize the sub-theme
      • Theme development with SCSS
        • Prerequisites & setup
        • Writing & compiling SCSS
    • Updating a site
      • Updating the Drupal Kit
        • Updating a Pantheon site
        • Updating a non-Pantheon site
      • All other updates (including add-ons)
        • Method One: Apply all available updates
        • Method Two: Apply all “UTexas” updates
        • Method Three: Update specific packages
      • General update reminders
    • Layout Builder Styles
      • Overview
    • Responsive images
      • Default configuration settings
    • Text formats
      • Flex HTML
      • Basic HTML
      • Restricted HTML
      • Full HTML
    • Configuration: what can and cannot be modified
      • ITS-managed configuration
      • Default configuration
      • Use Drupal’s Config Override system for modifications
    • Install and manage contributed modules/themes
    • Add a shareable custom module/theme
    • Add a site-specific custom module/theme
    • Add third-party libraries
    • Remove all Pantheon components from codebase
    • Secure sensitive credentials

Quick Reference

  • Troubleshooting
    • Content editing and site configuration
      • Cannot delete files, or deleted files are showing up in search results
      • Tables do not have borders or padding
      • Change Twitter icon to new X logo
      • The &commat; at symbol (@) renders incorrectly
      • Main menu links display when signed in but don’t show when signed out
      • The status report page shows a “mismatched entity field definitions” error
      • How to link to a section within a web page
      • How to find all instances of content or links across the site
      • Accessibility scanning tools report a violation: “Document has required lang attribute”
      • The blue Drupal icon is showing in the browser tab as the favicon
    • Development
      • Pantheon updates do not apply when using the “Apply Upstream updates” button
      • File changes pushed to Pantheon do not take effect
      • Package incompatibility with Composer 2
      • Update command in documentation fails to update the Kit
        • Pantheon sites
        • Non-Pantheon sites
      • Command fails with git@github.austin.utexas.edu: Permission denied (publickey)
      • Main menu does not display third-level (L3) items
      • “The “Grid display” for Views isn’t working”
  • Getting support
    • Web Publishing Office Hours
    • Ticket support
    • Community support
  • Drupal Kit Managed
  • Changelog and release notes
    • UT Drupal Kit 3.26.1 release notes
      • Release summary
      • Drupal core and contributed module updates
      • All changes since 3.26.0
    • UT Drupal Kit 3.26.0 release notes
      • Release summary
      • Developer callouts
      • Contributed code updates
        • UTexas installation profile dependency updates (8)
        • News add-on dependency updates (1)
        • Event add-on dependency updates (1)
      • All changes since 3.25.0
        • UTexas installation profile (17)
        • Forty Acres theme (1)
        • News add-on (2)
        • Event add-on (2)
        • Upstream repository (2)
    • UT Drupal Kit 3.25.0 release notes
      • Release summary
      • Developer callout
      • Drupal core updates
      • Contributed module updates
        • Event add-on dependency updates (2)
      • All changes since 3.24.0
        • UTexas installation profile (16)
        • Forty Acres theme (4)
        • News add-on (1)
        • Event add-on (1)
        • Upstream repository (1)
    • UT Drupal Kit 3.24.0 release notes
      • Release summary
      • Visual changes
      • Drupal core updates
      • Contributed code updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the News add-on
        • Modules included with the Profile add-on
      • All changes since 3.23.0
        • UTexas installation profile (14)
        • Forty Acres theme (5)
        • News add-on (3)
        • Enterprise Login integration (1)
        • Drupal Kit ‘Managed’ integration (3)
        • Role-based access (1)
        • “No authenticated user” module (1)
    • UT Drupal Kit 3.23.0 release notes
      • Release summary
      • Visual changes
      • New setup for Enterprise Authentication
      • Developer callouts
        • The original Slick slider library has been removed
        • The module “SVG Upload Sanitizer” has been removed
      • Drupal core updates
      • All changes since 3.22.1
      • Contributed code updates
        • UTexas installation profile dependency updates (10)
        • Event add-on dependency updates (3)
      • All changes since 3.22.0
        • UTexas installation profile (34)
        • Forty Acres theme (17)
        • Profile add-on (1)
        • News add-on (1)
        • Event add-on (3)
        • Upstream repository (3)
        • Enterprise Login integration (4)
        • Log forwarding service (1)
    • UT Drupal Kit 3.22.1 release notes
      • Release summary
      • Drupal core updates
      • Contributed module updates
      • All changes since 3.22.0
    • UT Drupal Kit 3.22.0 release notes
      • Release summary
      • Visual changes
        • Feed blocks now automatically append external link icons
      • Functional changes
        • Event add-on now includes a machine-readable feed for calendar.utexas.edu
        • Past events can now be automatically archived
      • Developer callouts
        • Bootstrap 5 negative margin utility classes now included
      • Contributed code updates
        • UTexas installation profile dependency updates (10)
        • News add-on dependency updates
      • All changes since 3.21.1
        • UTexas installation profile (9)
        • Forty Acres theme (5)
        • News add-on (2)
        • Event add-on (3)
        • Upstream repository (1)
    • UT Drupal Kit 3.21.1 release notes
      • Release summary
        • Instagram API has changed
        • Forty Acres: Legacy Bootstrap margin utilities added
      • Drupal core updates
      • Contributed module updates
      • All changes since 3.21.0
        • Forty Acres theme (1)
        • UTexas installation profile (1)
    • UT Drupal Kit 3.21.0 release notes
      • Release summary
      • Visual changes
        • Forty Acres now uses Bootstrap framework version 5, updated from version 4
        • Event add-on has modernized the ‘add to calendar’ pop-up
        • Site announcement now displays text in readable width
        • Focus indicators are now scoped to browser heuristics
      • Additional developer callouts
      • Drupal core updates
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the News add-on
        • Modules included with the Event add-on
        • Modules included with the Profile add-on
      • All changes since 3.20.3
        • UTexas installation profile (20)
        • Forty Acres theme (10)
        • News add-on (1)
        • Event add-on (5)
        • Upstream repository (4)
        • Enterprise Authentication integration (2)
        • Drupal Kit ‘Managed’ integration (1)
    • UT Drupal Kit 3.20.3 release notes
      • Release summary
      • All changes since 3.20.2
      • Drupal core updates
      • Contributed module updates
    • UT Drupal Kit 3.20.2 release notes
      • Release summary
      • All changes since 3.20.1
    • UT Drupal Kit 3.20.1 release notes
      • Release summary
        • What actions are required?
      • All changes since 3.20.0
        • Event add-on
    • UT Drupal Kit 3.20.0 release notes
      • Release summary
      • Visual changes
        • Section backgrounds now display full-width for all content widths
        • Horizontal tabs now visually associate the tab labels with their content
        • HTML <details> elements now display with default “Accordion” design
        • Component headlines now have equal padding and line height
        • Event pages now link related events by type and location
        • Event listing pages have relocated filters adjacent to buttons
        • Keyboard navigation focus indicator has improved color contrast
        • Copy text font size has been standardized
        • Profile (People) Listings using the “Basic” display have been improved
      • Additional developer callouts
      • Drupal core updates
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the News add-on
        • Modules included with the Event add-on
        • Modules included with the Profile add-on
      • All changes since 3.19.1
        • UTexas installation profile (25)
        • Forty Acres theme (12)
        • Profile add-on (4)
        • News add-on (5)
        • Event add-on (7)
        • Upstream repository (1)
        • Enterprise Login integration (2)
        • Role-based access (1)
    • UT Drupal Kit 3.19.1 release notes
      • Release summary
      • Drupal core updates
      • Contributed module updates
      • All changes since 3.19.0
    • UT Drupal Kit 3.19.0 release notes
      • Release summary
      • Visual changes
        • Required footer links now display with an external link icon
        • Header menu items now display active child page indicator
        • Instagram now includes headline field, linkable to Instagram account
        • Cancelled events no longer display the ‘Add to calendar’ link
        • Tips for advanced searches now display on the search page
        • Promo Unit textual content now consistently aligns with other content
        • Background color options for layouts have been consolidated
        • Profile lists now wrap text around image
        • Spacing between Profile title and content now matches other pages
      • Drupal core updates
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the News add-on
        • Modules included with the Profile add-on
        • Modules included with the Event add-on
      • All changes since 3.18.0
        • UTexas installation profile (28)
        • Forty Acres theme (6)
        • Profile add-on (7)
        • News add-on (3)
        • Event add-on (4)
        • Upstream repository (3)
        • Qualtrics text filter (1)
        • Log forwarding service (1)
        • Role-based access (1)
        • Accessible Mega Menu (1)
        • “No authenticated user” module (1)
    • UT Drupal Kit 3.18.0 release notes
      • Release summary
      • Visual changes
        • Hero Carousel controls now display at top of image on small screens
        • Block titles now display with hierarchically-correct font size
        • Column content no longer overlaps on small screens
        • Promo Unit landscape image aspect ratio has changed slightly
        • Featured Highlight padding, font-size, image size, and stacking have changed
      • Drupal core updates
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the News add-on
        • Modules included with the Profile add-on
        • Modules included with the Event add-on
      • All changes since 3.17.1
        • UTexas installation profile (15)
        • Forty Acres theme (9)
        • Profile add-on (1)
        • News add-on (1)
        • Event add-on (4)
        • Upstream repository (1)
    • UT Drupal Kit 3.17.1 release notes
      • Release summary
      • Drupal core updates
      • Contributed module updates
      • All changes since 3.17.0
        • Forty Acres Theme
    • UT Drupal Kit 3.17.0 release notes
      • Release summary
      • Visual changes
        • Hyperlinks with long link text now wrap within narrow displays
        • Pages with a parent in the main menu will show the parent as “active”
        • Event Calendar, Upcoming, and Past Events pages now include search filters
        • Tables generated by the Views module now include borders by default
        • Flex List headers now display with hierarchically-correct font-size
      • Drupal core updates
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the News add-on
      • All changes since 3.16.2
        • UTexas installation profile (35)
        • Forty Acres theme (11)
        • Profile add-on (4)
        • News add-on (10)
        • Event add-on (8)
        • Drupal Kit ‘Managed’ integration (2)
    • UT Drupal Kit 3.16.2 release notes
      • Release summary
      • Drupal core updates
      • Contributed module updates
      • All changes since 3.16.1
        • UTexas installation profile
        • Profile add-on (released February 23, 2024)
    • UT Drupal Kit 3.16.1 release notes
      • Release summary
      • Drupal core updates
      • Contributed module updates
      • All changes since 3.16.0
        • UTexas installation profile
        • Event add-on
        • Profile add-on
    • UT Drupal Kit 3.16.0 release notes
      • Release summary
        • Forty Acres now provides main menu alignment options
        • “Share this” icon for X (formerly Twitter) has been updated
        • Flex Content Area headlines can be links without requiring a call to action link
        • The name attribute is allowed on HTML <a> tags
      • Drupal core updates
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the Event add-on
        • Modules included with the News add-on
        • Modules included with the Profile add-on
      • All changes since 3.15.1
        • UTexas installation profile (15)
        • Forty Acres theme (9)
        • Profile add-on (3)
        • News add-on (5)
        • Event add-on (3)
        • Upstream repository (2)
        • Enterprise Login integration (2)
        • Migration tool (2)
    • UT Drupal Kit 3.15.1 release notes
      • Release summary
      • All changes since 3.15.0
        • UTexas installation profile
    • UT Drupal Kit 3.15.0 release notes
      • Release summary
        • Social media icon replacement for X (formerly Twitter)
        • Hero Style text background changed
        • New “Table padding” style in CKEditor
      • Drupal core updates
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the Event add-on
        • Modules included with the News add-on
      • All changes since 3.14.1
        • UTexas installation profile (20)
        • Forty Acres theme (10)
        • Profile add-on (1)
        • News add-on (3)
        • Event add-on (3)
        • Documentation (29)
        • Enterprise Login integration (1)
        • Drupal Kit ‘Managed’ integration (3)
        • Qualtrics text filter (1)
        • Log forwarding service (1)
        • Role-based access (1)
        • Migration tool (1)
        • Accessible Mega Menu (3)
        • “No authenticated user” module (1)
    • UT Drupal Kit 3.14.1 release notes
      • Release summary
        • What sites are affected?
        • What actions are required?
      • All changes since 3.14.0
        • Event add-on
        • News add-on
        • Profile add-on
    • UT Drupal Kit 3.14.0 release notes
      • Release summary
        • Ability to create content drafts prior to publishing
        • Selected styles can be applied to rich text through the “Styles dropdown”
        • Path exclusions for Google Tag Manager have been standardized
        • Multi-item components are now draggable and removable
      • Drupal core updates
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the Event add-on
      • All changes since 3.13.1
        • UTexas installation profile (26)
        • Forty Acres theme (2)
        • Profile add-on (2)
        • News add-on (3)
        • Event add-on (7)
        • Documentation (19)
        • Drupal Kit ‘Managed’ integration (2)
        • Migration tool (2)
    • UT Drupal Kit 3.13.1 release notes
      • Release summary
      • Update actions for existing sites
      • All changes since 3.13.0
        • UTexas installation profile
    • UT Drupal Kit 3.13.0 release notes
      • Release summary
        • Twitter content removed
        • Promo Unit link behavior changed
        • Block library location changed
        • Bulk operations interface changed
      • Drupal core updates
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
      • All changes since 3.12.0
        • UTexas installation profile (23)
        • Forty Acres theme (2)
        • Upstream repository (1)
        • Documentation (4)
        • Role-based access (1)
    • UT Drupal Kit 3.12.0 release notes
      • Release summary
      • Major version update: Drupal 9 to 10
      • Bootstrap dropdown library removed from Forty Acres
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the News add-on
        • Modules included with the Event add-on
        • Modules included with the Profile add-on
      • All changes since 3.11.3
        • UTexas installation profile (14)
        • Forty Acres theme (4)
        • Profile add-on (3)
        • News add-on (3)
        • Event add-on (6)
        • Upstream repository (3)
        • Documentation (2)
        • Enterprise Login integration (5)
        • Drupal Kit ‘Managed’ integration (2)
        • Log forwarding service (2)
        • Migration tool (3)
    • UT Drupal Kit 3.11.3 release notes
      • Release summary
      • Drupal core update
      • All changes since 3.11.1
        • UTexas installation profile
    • UT Drupal Kit 3.11.1 release notes
      • Release summary
      • Update actions for existing sites
      • All changes since 3.11.0
        • UTexas installation profile
    • UT Drupal Kit 3.11.0 release notes
      • Release summary
      • PHP 8 update
      • CKEditor 5 update
      • Instagram Feed component
      • Action item for non-Forty Acres themes
      • Drupal core update
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the Event add-on
        • Modules included with the Profile add-on
      • All changes since 3.10.0
        • UTexas installation profile
        • Forty Acres theme
        • News add-on
        • Event add-on
        • Profile add-on
        • Upstream repository
        • Documentation
    • UT Drupal Kit 3.10.0 release notes
      • Release summary
      • Drupal core update
      • Bugfix for data loss related to page cloning
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the News add-on
        • Modules included with the Event add-on
      • Update actions for existing sites
      • All changes since 3.9.1
        • UTexas installation profile
        • Forty Acres theme
        • Event add-on
        • News add-on
        • Profile add-on
        • Upstream repository
        • Pantheon SAML Integration
        • Documentation
    • UT Drupal Kit 3.9.1 release notes
      • Release summary
      • Update actions for existing sites
      • All changes since 3.9.0
        • Forty Acres theme
    • UT Drupal Kit 3.9.0 release notes
      • Release summary
      • User Interface Change - Layout Builder Styles Grouping
      • Major version update - Facets module
      • Drupal core update
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the News add-on
        • Modules included with the Profile add-on
      • Update actions for existing sites
      • All changes since 3.8.0
        • UTexas installation profile
        • Forty Acres theme
        • News add-on
        • Event add-on
    • UT Drupal Kit 3.8.0 release notes
      • Release summary
      • Drupal core update
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the Event add-on
        • Modules included with the News add-on
        • Modules included with the Profile add-on
      • Update actions for existing sites
      • All changes since 3.7.1
        • UTexas installation profile
        • News add-on
        • Event add-on
        • Profile add-on
    • UT Drupal Kit 3.7.1 release notes
      • Release summary
      • Update actions for existing sites
      • All changes since 3.7.0
        • UTexas installation profile
    • UT Drupal Kit 3.7.0 release notes
      • Release summary
      • PHP 8 compatibility
      • Drupal core update
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the Event add-on
        • Modules included with the News add-on
      • Update actions for existing sites
      • All changes since 3.6.1
        • UTexas installation profile
        • Forty Acres theme
        • News add-on
        • Event add-on
        • Profile add-on
    • UT Drupal Kit 3.6.1 release notes
      • Release summary
      • Update actions for existing sites
      • All changes since 3.6.0
        • Forty Acres theme
    • UT Drupal Kit 3.6.0 release notes
      • Release summary
      • New component - “Hero Carousel”
      • New display option - “Calendar of Events”
      • Drupal core update
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the Event add-on
      • Update actions for existing sites
      • All changes since 3.5.2
        • UTexas installation profile
        • News add-on
        • Event add-on
        • Profile add-on
    • UT Drupal Kit 3.5.2 release notes
      • Release summary
      • All changes since 3.5.1
        • UTexas installation profile
        • News add-on
        • Event add-on
        • Profile add-on
    • UT Drupal Kit 3.5.1 release notes
      • Release summary
      • All changes since 3.5.0
        • UTexas installation profile
        • News add-on
        • Event add-on
        • Profile add-on
    • UT Drupal Kit 3.5.0 release notes
      • Release summary
      • Drupal core update
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the Event add-on
        • Modules included with the News add-on
      • Update actions for existing sites
      • All changes since 3.4.1
        • UTexas installation profile
        • Forty Acres theme
        • News add-on
        • Event add-on
    • UT Drupal Kit 3.4.1 release notes
      • Release summary
      • Drupal core update
      • Contributed module updates
        • Modules included with the UT Drupal Kit installation profile
        • Modules included with the Profile add-on
        • Modules included with the Event add-on
        • Modules included with the News add-on
      • New features
        • New display options for the Flex List component
        • Automatic anchors for all header tags
        • Adding borders around images in components
        • Page and taxonomy term cloning
        • “Add to Calendar” on Events
      • Update actions for existing sites
      • All changes since 3.3.0
        • UTexas installation profile
        • Forty Acres theme
        • Profile add-on
        • News add-on
        • Event add-on
    • UT Drupal Kit 3.3.0 release notes
      • Release summary
      • Drupal core update
      • Contributed module updates
      • Update action items for existing sites
        • “Flex HTML” text format changes
      • All changes since 3.2.0
        • UTexas installation profile
        • Forty Acres theme
        • Profile add-on
        • News add-on
        • Event add-on
    • UT Drupal Kit 3.2.0 release notes
      • Release summary
      • Drupal core update
      • Contributed module updates
      • Update action items for existing sites
        • “Full HTML” text format changes
        • Bootstrap version update
        • “Administer blocks” permission added to default site management permission set
      • All changes since 3.1.0
        • UTexas installation profile
        • Forty Acres theme
        • Profile add-on
        • News add-on
        • Event add-on
    • UT Drupal Kit 3.1.0 release notes
      • Release summary
      • For developers who installed UT Drupal Kit prior to 3.0.0
      • Deprecation notice: utexas/utexas_pantheon_sam_auth
      • All changes since 3.0.0
        • UTexas installation profile
        • Forty Acres theme
        • Profile add-on
        • News add-on
        • Event add-on
        • Pantheon SAML Integration
        • UTDK Project
    • UT Drupal Kit 3.0.0 release notes
      • Release summary
      • Update actions for existing sites
        • Add custom Composer installer paths
        • Change plugin for Enterprise Authentication
        • Change version constraints for add-ons
        • Discontinue use of UTexasLinkElement
      • All changes since 3.0.0-RC.2
        • UTexas installation profile
        • Forty Acres theme
        • Profile add-on
        • News add-on
        • Event add-on
    • UT Drupal Kit 3.0.0-RC.2 release notes
      • Release summary
      • Update actions for existing sites
      • All changes since 3.0.0-RC.1
        • Task
    • UT Drupal Kit 3.0.0-RC.1 release notes
      • Release summary
      • Update actions for existing sites
        • Adminimal Theme has been removed
        • Installation profile is relocated to “custom” directory
      • All changes since 3.0.0-beta.10.2
        • Bug fix
        • Task
    • UT Drupal Kit 3.0.0-beta.10.2 release notes
      • Release summary
      • All changes since 3.0.0-beta.10.2
        • Bug fix
    • UT Drupal Kit 3.0.0-beta.10.1 release notes
      • Release summary
      • Release-specific update steps
      • All changes since 3.0.0-beta.10.1
        • UT Drupal Kit kernel
    • UT Drupal Kit 3.0.0-beta.10 release notes
      • Special release note: Updating to Drupal 9
        • Tasks not specific to the UT Drupal Kit
        • Tasks specific to the UT Drupal Kit
      • Release summary
      • Contributed module updates
      • All changes since 3.0.0-beta.9.1
        • UT Drupal Kit kernel
        • Forty Acres
        • News add-on
        • Profile add-on
        • Event add-on
        • UTexas SAML authentication helper
    • UT Drupal Kit 3.0.0-beta.9.1 release notes
      • Release summary
      • All changes since 3.0.0-beta.9.1
        • UT Drupal Kit kernel
        • Profile add-on
    • UT Drupal Kit 3.0.0-beta.9 release notes
      • Release summary
      • Contributed module updates
      • All changes since 3.0.0-beta.8.1
        • UT Drupal Kit kernel
        • Forty Acres
        • News add-on
        • Profile add-on
        • Event add-on
    • UT Drupal Kit 3.0.0-beta.8.1 release notes
      • Release summary
      • All changes since 3.0.0-beta.8
        • UT Drupal Kit kernel
    • UT Drupal Kit 3.0.0-beta.8 release notes
      • Release summary
        • New layout features
        • Accessibility improvements
        • Callout: Media Library Form Element module update require users to clear browser cache
        • Callout: Twitter profile widget
        • Contributed module updates
      • All changes since 3.0.0-beta.7.1
        • UT Drupal Kit kernel
        • Forty Acres
        • News add-on
        • Profile add-on
        • Event add-on
    • UT Drupal Kit 3.0.0-beta.7.1 release notes
      • Release summary
      • All changes since 3.0.0-beta.7
        • Task
    • UT Drupal Kit 3.0.0-beta.7 release notes
      • Release summary
        • Event add-on now available (1.0.0-alpha.1)
        • News add-on
        • Callout: scaffold location of “UTexas” installation profile moved
        • Contributed module updates
      • All changes since 3.0.0-beta.6
        • UT Drupal Kit kernel
        • Forty Acres
        • News add-on
        • Profile add-on
        • Event add-on
    • UT Drupal Kit 3.0.0-beta.6 release notes
      • Release summary
        • UT Drupal Kit kernel
        • Important: Update protocol for Beta 6
        • News add-on update
        • Profile add-on update
        • Contributed module updates
      • All changes since 3.0.0-beta.5.2
        • UT Drupal Kit kernel
        • Forty Acres
        • News add-on
        • Profile add-on
        • Qualtrics Filter
    • UT Drupal Kit 3.0.0-beta.5.2 release notes
      • Release summary
      • All changes since 3.0.0-beta.5.1
        • Bug fix
    • UT Drupal Kit 3.0.0-beta.5.1 release notes
      • Release summary
      • Known Issues
      • All changes since 3.0.0-beta.5
        • UT Drupal Kit kernel
    • UT Drupal Kit 3.0.0-beta.5 release notes
      • Release summary
        • Profile add-on update
        • News add-on now available
        • Contributed module updates
      • All changes since 3.0.0-beta.4
        • UT Drupal Kit kernel
        • Forty Acres
        • News add-on
        • Profile add-on
    • UT Drupal Kit 3.0.0-beta.4 release notes
      • Release summary
        • Changes since 3.0.0-beta.3
      • Profile add-on now available
      • Enterprise Authentication available for Pantheon-hosted sites
    • UT Drupal Kit 3.0.0-beta.3 release notes
      • Release summary
      • All changes since 3.0.0-beta.2
        • Enhancements
        • Tasks
        • Bugs
        • Documentation
    • UT Drupal Kit 3.0.0-beta.2 release notes
      • Release summary
      • All changes since 3.0.0-beta.1
        • Enhancements
        • Bugs
        • Documentation
    • UT Drupal Kit 3.0.0-beta.1 release notes
      • Release summary
        • What’s missing?
      • Stability and forwards compatibility
      • Issues
        • Story
        • Bug
        • Task
        • Sub-task
    • UT Drupal Kit 3.0.0-alpha.4 release notes
      • Release summary
      • Issues
        • Story
        • Bug
        • Task
        • Sub-task
    • UT Drupal Kit 3.0.0-alpha.3 release notes
      • Release summary
      • Issues
        • Story
      • Bug
      • Task
      • Sub-task
    • UT Drupal Kit 3.0.0-alpha.2 release notes
      • Release summary
      • Issues
        • Story
      • Task
    • UT Drupal Kit 3.0.0-alpha.1 release notes
      • Release summary
      • Issues
        • Story
        • Bug
        • Task
        • Sub-task
    • Versioning Policy
UT Drupal Kit Documentation
  • »
  • Creating and managing content »
  • Working with rich text editors »
  • How to add icons and buttons to links
  • Changelog & release notes

How to add icons and buttons to links

Content editors adding content through the rich text editor can configure how links display using the interface shown below. Access this interface through the following steps:

  1. Highlight text in the rich text editor

  2. Click the “Link” icon in the toolbar.

  3. Select one or more link options.

Site-wide blocks listed in the right sidebar of a Flex Page.
  • Primary button: Display the link as a burnt orange button. Appropriate when the destination website is a form or other interactive tool.

  • Secondary button: Display the link as a white button with a burnt orange border. Appropriate when the destination website is a form or other interactive tool.

  • Authentication required icon: Indicate that a visitor must authenticate to access information at the link destination

  • External link icon: Indicate that the link leads to a different website. Choosing this will not automatically cause the link to open in a new window. See below.

  • Right-facing caret: This does not have an explicit meaning; it is largely decorative.

  • Open in new tab: Cause the link to open in a new window/tab, rather than replacing the existing tab. This may be appropriate for external websites. Choosing this will not automatically add the “external link” icon, above.

Mutually-conflicting styles

This interface allows adding multiple link behaviors simultaneously. It is the responsibility of the content editor to ensure that multiple selected options are semantically correct. For example, a content editor should not choose the “Primary button” and “Secondary button” style together.

Previous Next

© Copyright 2017- ITS Web & Consulting Services