Skip to content

ActiveAdmin support ​

This page lists which ActiveAdmin constructs the API and client handle. Use it to decide whether a resource is ready, or which parts still need the classic admin.

Status ​

  • Supported. The construct works and returns typed output.
  • Degraded. The construct renders, but it loses behavior. The gem logs a warning or uses a fallback.
  • In progress. Code exists, but coverage is partial.
  • Not supported. The construct is ignored, or the request returns an error.

Entries marked (check) rest on code reading or on the 2026-10-16 review. Verify them against your app before you rely on them.

Index, show, form and page responses list what they fell back to in a degraded array of {kind, where, reason}. where is a structural path such as index/column[title] or form/section[1], and reason names the exception class, never its message or any record data. Each entry also publishes an ActiveSupport::Notifications event, degraded.reactiveadmin, with resource, action, kind and where (plus synthetic: true for the doctor's own samples), and the response carries X-Reactiveadmin-Degraded: <count>. A cell that fails renders as an error node, not empty. For fixes in your admin code, run rake reactiveadmin:doctor.

Index ​

ConstructStatusNotes
index table with symbol and block columnsSupportedSymbol columns send typed values. Block columns render typed nodes, with HTML only where no node type fits.
Column sortable and sort_keySupported (check)The review found a 500 when sorting a block column whose symbol is a database column. The code now sorts on a copy of the column. Verify on your resources.
selectable_column, id_column, index_columnSupportedThe client derives row selection from batch actions.
Cell block raisesDegradedThe cell renders as an error node and the response lists a cell_failed entry. The gem logs a warning.
Index block raisesDegradedFalls back to the default columns. The gem logs a warning.
index as: :grid, :blog, :block, or customNot supportedIgnored. The default table renders with no signal.
Multiple index views (?as=)Not supportedOnly the default view is available.
actions do |r| item ... end row itemsSupported (check)Rendered as row controls.
per_page arraySupportedThe client offers the declared options.
max_per_pageSupportedActiveAdmin doesn't cap per_page. The API clamps it to the lower of the resource's max_per_page and ReactiveAdmin.config.max_per_page (default 100), unless the resource offers larger sizes in per_page.
pagination_total: falseSupportedTotal counts are null. A one-row probe finds the next page.
scope_count: falseSupportedScope counts are omitted.
Scope counts (show_count)SupportedCounts come back with the index response, one query per scope.
Scope group:SupportedEach group's scopes stay together, in order of first appearance. A default scope inside a group is the current one.
Scope if:Supported (check)Evaluated per request.
download_links and csv doSupportedGET /api/admin/<resource>.csv streams ActiveAdmin's CSV. The client's export UI: check.
Filters: string, numeric, date range, boolean, selectSupportedTyped controls in the manifest.
Filters: as: :datalist or :typeahead with source:SupportedSearchable typeahead through _options.
Filters: check_boxes with multipleSupportedToggle buttons, one per option, filtering with q[attr_in][]; the active choices show as one removable chip. Association and numeric columns too. A relation-backed collection becomes a multiple typeahead.
Filter if: and unless:Supported (check)Evaluated per request.
Filter options that depend on other valuesSupported (check)_options evaluates the collection with the request's view context.
Filters disabled with filters = falseSupportedNo filter controls are sent.
Undeclared q[...] predicatesSupportedRejected with 400 and code invalid. The API honors declared filters only.
Custom ransackersSupportedUsed for type inference.
"Current filters" sidebarReplacedThe client shows active filters as removable chips.

Forms and writes ​

ConstructStatusNotes
form do |f| inputs, has_many, and errorsSupportedField errors return in a 422 with code invalid.
has_many rows with a single controlSupportedShown as a compact list instead of cards. Override per association with nested_layout. A failed write names the row that failed in row_errors.
semantic_fields_for and fields_for with index:SupportedEach row of a repeated group posts under the name Rails gives it (parent[rows][0][email]), so an API write carries the same params as the classic form. child_index: applies to nested-attributes associations only, as in Rails.
Date and datetime input_html: {min:, max:} and datepicker_options: {min_date:, max_date:}SupportedThe client disables days outside the range and flags a typed value outside it. A date, time, ISO string, number of days, or relative string such as +1m works. The server doesn't validate: do that in the model.
Content in a form do |f| block: headings, panels, attributes_table_for, paragraphsSupportedWalked into typed nodes, as on a show page, and sent as content fields between the inputs. See Content in a form.
as: :typeahead or :datalist in formsSupportedUses source: and _options.
Custom Formtastic inputs in app/admin/inputsDegradedSent as a read-only HTML field.
form partial:Supported (check)Formtastic inputs in the partial are typed fields. Other markup stays html. Raw inputs make the form non-submittable. See Custom views.
Form block raisesDegradedFalls back to the default form. The gem logs a warning.
render :new or :edit after a failed writeSupportedReturns 422 with field errors, keyed by the name of the field that posts each attribute. A custom create can render new with its record in @resource.
def new or def edit that calls super { ... }SupportedThe block runs before the form is described, so values it sets on resource are the form's defaults. A block that takes the format argument is skipped.
Blank valuesSame as classicThe server posts a null text-like or select field as "", as a browser would, and drops an unselected radio. Booleans, files and lists keep their types.
json fieldsSame as classicPosted as JSON text, so permit_params :attr takes it and your code parses it. A host that permits attr: {} gets the structure instead. A null posts "".

Show pages ​

ConstructStatusNotes
Attributes tables, panels, and tablesSupportedTyped attributes_table, panel, and table nodes.
tabs and columnsSupported (check)Typed tabs and columns nodes.
Layout classes, such as flex, lg:flex-row, w-2/3, mt-4, font-bold, and text-mutedSupportedA safelisted subset maps to typed hints (layout, width, spacing, text alignment, marks, tone). Other classes are ignored and reported. See Layout classes and inline styles.
Inline style:Partly supportedDeclarations that land exactly on the same vocabulary translate (margin-top: 8px, text-align: center, display: flex; gap: 20px). The rest are ignored and reported.
panel header_action:Not supported
button_to, link_to with data-method or data-confirmSupported (check)Converted to typed actions. Confirmation text is kept. A POST to a route of this host outside the admin navigates the browser (see Custom views).
paginated_collectionNot supported (check)Page links may drop the query string.
table_for sortable:Degraded (check)Sort links stay in the classic markup.
status_tag, auto_link, and links to resourcesSupportedTyped status and ref nodes.

Actions ​

ConstructStatusNotes
action_itemSupported (check)Rendered as header actions. Guards are honored.
clear_action_items!Supported
expose in reactive doSupportedLists a member or GET collection action as a header button.
Member action with POST, PUT, PATCH, or DELETE and redirect_toSupportedReturns {ok, id, message, location}, or 422 with errors.
Member action with GET that renders a templateDegradedServed through the ladder as native, frame, or iframe. Returns 501 unsupported when no mode fits (check).
Member GET that changes data and redirectsDegraded (check)Avoid it. The client may run the action again when it follows the redirect.
send_data and send_fileDegraded (check)Frame mode downloads attachments. Check the native path.
render json: in an actionSupportedPassed through as the response body.
respond_to and custom respondersDegradedWrites run as HTML and are translated to JSON. A GET without a reactiveadmin branch returns 501 unsupported.
redirect_back and referer redirectsDegraded (check)The referer is a client path, not always a route the API knows.
collection_actionSupported (check)A GET collection action can be exposed. A write action needs a form.
controller do overridesSupportedThe gem prepends its modules, so super reaches them.
Flash messagesSupportednotice becomes a toast. alert and error become errors. Other keys are dropped.
Nested resources with a required belongs_toSupportedRoutes under the parent. Top-level keys return 404.
Optional belongs_toSupportedTop-level and nested routes both work.
Decorators (decorate_with)Supported (check)ActiveAdmin applies decorations to the records. The gem has no dedicated spec for them.

Pages, menus, and chrome ​

ConstructStatusNotes
register_page contentSupported (check)Served at /api/admin/_pages/<key>. Plain content is typed, and Formtastic forms become native form nodes. Raw forms fall back to frame, scripts to iframe.
Page actionsSupported (check)
Page sidebarsNot supported
Custom ERB templatesDegradedChosen by the ladder: native for Formtastic-only forms, otherwise frame, iframe, or custom.
Menu parent, priority, if, and urlSupportedAA's menu.
ReactiveAdmin.menu overlaySupportedSee DSL.
Utility navigation, site title, logout, and faviconSupportedServed in the manifest's site object.
BreadcrumbsSupported (check)Built by the client.
display_name and display_name_methodsSupported
Active Admin commentsNot supportedThe gem doesn't hide a registered comments resource (check).
Impersonation bannerNot supported
ActiveAdmin JavaScriptSupportedDatepickers, has_many add and remove, dropdowns, and confirmations are rebuilt in the client. Frame mode doesn't run classic JavaScript. Iframe mode does.
LocalizationDegradedDates follow localize_format. Client UI strings are English only (check).
Authentication and CSRFSupportedSee Security.
Pundit adapter and per-row permissionsSupportedEach row carries its own permissions.
authorize_custom_actionsSupportedSee Configuration.