Technical Reference

Neut Widget WordPress Reference

Use this reference after the WordPress quickstart is working. It lists the widgets supported by the Neut Widgets plugin, the available shortcodes and blocks, accepted attributes, and the supported subject, status, and colorway values.

Start with WordPress Quickstart if you have not yet installed and configured the plugin.

For non-WordPress implementations, see the Customer Widget Quickstart, Customer Widget Reference, and Customer Widget Backend Guide.

Supported Widgets

Widget	Widget ID
Bill Preview	`bill-preview`
Vote Ledger	`vote-ledger`
Legislation Log	`legislation-log`

The plugin uses the Neut production widget host automatically:

https://widgets.neut.us

Customers do not need to configure that manually.

Supported Blocks

Block Title	Block Name
Bill Preview	`neut/bill-preview`
Vote Ledger	`neut/vote-ledger`
Legislation Log	`neut/legislation-log`

Supported Shortcodes

Widget	Shortcode
Bill Preview	`[neut_bill_preview ...]`
Vote Ledger	`[neut_vote_ledger ...]`
Legislation Log	`[neut_legislation_log ...]`

Common Rules

instance_id is required for every widget.
instance_id may contain only letters, numbers, dot, underscore, colon, or hyphen.
instance_id must be 128 characters or fewer.
congress, page, limit, bill_number, and district must be positive integers when provided.
colorway defaults to Default if omitted.

Bill Preview

Use this widget when the page is about a specific federal or state bill.

Shortcode:

[neut_bill_preview ...]

Shared Bill Preview Attributes

`instance_id`

Type: string
Required: Yes
Example: bill-preview-article-123-main

Unique widget placement ID.

`source`

Type: string
Required: No
Example: congress

Omit or send congress for federal bills. Send state for state bills.

`article_id`

Type: string
Required: No
Example: article-123

Optional tracing value.

`colorway`

Type: string
Required: No
Example: Default

Optional style selection.

Congress Bill Preview Attributes

Required when source is omitted or source="congress":

`bill_type`

Type: string
Required: Yes
Example: HR

Bill type.

`bill_number`

Type: integer
Required: Yes
Example: 1

Positive bill number.

`congress`

Type: integer
Required: Yes
Example: 119

Positive Congress number.

`temp_text_url`

Type: string
Required: No
Example: https://www.congress.gov/119/bills/hr1/BILLS-119hr1ih.pdf

Congress-only HTTPS fallback bill text URL.

`temp_title`

Type: string
Required: No
Example: Sample Bill Title

Congress-only fallback title for same-day bill coverage.

State Bill Preview Attributes

Required when source="state":

`source`

Type: string
Required: Yes
Example: state

Enables state bill preview mode.

`state`

Type: string
Required: Yes
Example: CA

Two-letter state or territory code.

`bill_identifier`

Type: string
Required: Yes
Example: AB 123

Full visible bill identifier.

`session`

Type: string
Required: No
Example: 2025

Optional legislative session identifier.

Bill Preview Examples

Congress example:

[neut_bill_preview
  instance_id="bill-preview-article-123-main"
  source="congress"
  bill_type="HR"
  bill_number="1"
  congress="119"
  article_id="article-123"
  colorway="Default"]

State example:

[neut_bill_preview
  instance_id="bill-preview-ca-ab-123"
  source="state"
  state="CA"
  bill_identifier="AB 123"
  session="2025"
  colorway="Default"]

Vote Ledger

Use this widget to show House roll call votes for a representative, or a general House roll call feed.

Shortcode:

[neut_vote_ledger ...]

`instance_id`

Type: string
Required: Yes
Example: vote-ledger-lofgren-ca-18

Unique widget placement ID.

`congress`

Type: integer
Required: Yes
Example: 119

Positive Congress number.

`page`

Type: integer
Required: No
Example: 1

Defaults to 1 if omitted.

`limit`

Type: integer
Required: No
Example: 5

Defaults to 10 if omitted.

`member_type`

Type: string
Required: Conditional
Example: Representative

Must currently be Representative when targeting a single member.

`last_name`

Type: string
Required: Conditional
Example: Lofgren

Required only when targeting a single member.

`state_code`

Type: string
Required: Conditional
Example: CA

Required only when targeting a single member. Must be a two-letter code.

`district`

Type: integer
Required: No
Example: 18

Allowed only for Representative.

`colorway`

Type: string
Required: No
Example: Paper

Optional style selection.

`show_member_hero`

Type: boolean
Required: No
Example: true

Optional display flag.

Vote Ledger Member Rules

To target a single member, provide member_type, last_name, and state_code together.
For representatives, district is optional.
For a general House roll call feed, omit member_type, last_name, state_code, and district together.
vote-ledger currently supports House roll call votes only. Senate recorded votes are not available in this widget yet.

Vote Ledger Examples

Representative example:

[neut_vote_ledger
  instance_id="vote-ledger-lofgren-ca-18"
  member_type="Representative"
  last_name="Lofgren"
  state_code="CA"
  district="18"
  congress="119"
  limit="5"
  colorway="Paper"]

General feed example:

[neut_vote_ledger
  instance_id="vote-ledger-general-feed"
  congress="119"
  limit="5"
  colorway="Paper"]

Legislation Log

Use this widget on an issue or policy page. It supports three backend-backed modes:

congress (default when source is omitted): Congress parent-subject ledger or Congress saved custom subject filter
state: statewide state bill ledger

Existing Congress embeds may continue omitting source. New generated examples should include source="congress" for clarity.

Shortcode:

[neut_legislation_log ...]

Legislation Log Attributes

`instance_id`

Type: string
Required: Yes
Example: legislation-lofgren-health

Unique widget placement ID.

`source`

Type: string
Required: No
Example: congress

Omit or send congress for Congress mode. Send state for the state bill ledger.

`page`

Type: integer
Required: No
Example: 1

Defaults to 1 if omitted.

`limit`

Type: integer
Required: No
Example: 10

Defaults to 10 if omitted.

`colorway`

Type: string
Required: No
Example: WashedSage

Optional style selection.

`congress`

Type: integer
Required: Congress
Example: 119

Required for Congress mode.

`subject`

Type: string
Required: Congress parent
Example: Health & Social Welfare

Required for Congress parent-subject mode. Must match a supported subject, including All.

`custom_subject_filter_id`

Type: string
Required: Congress custom
Example: 550e8400-e29b-41d4-a716-446655440000

Required for Congress custom-filter mode. Tenant custom filter UUID.

`status_filter`

Type: string
Required: Congress
Example: All

Defaults to All if omitted.

`member_type`

Type: string
Required: No
Example: Representative

Optional member targeting. Must be Representative or Senator.

`last_name`

Type: string
Required: No
Example: Lofgren

Required only when targeting a single member.

`state_code`

Type: string
Required: No
Example: CA

Required only when targeting a single member. Must be a two-letter code.

`district`

Type: integer
Required: No
Example: 18

Allowed only for Representative. Omit for senators.

`state`

Type: string
Required: State
Example: CA

Required for state mode. Two-letter state or territory code.

`show_member_hero`

Type: boolean
Required: No
Example: true

Optional display flag. Congress only.

`show_subject_filter`

Type: boolean
Required: No
Example: false

Optional display flag. Congress only.

`show_status_filter`

Type: boolean
Required: No
Example: false

Optional display flag. Congress only.

Send exactly one of subject or custom_subject_filter_id in Congress mode. Do not send both.

Arbitrary free-text custom subjects are still not supported. custom_subject_filter_id refers only to saved tenant filters configured in Neut.

Legislation Log Member Rules

To target a single member, provide member_type, last_name, and state_code together.
For representatives, district is optional.
For senators, omit district.
For a general subject view, omit member_type, last_name, state_code, and district together.

Legislation Log State Rules

State mode requires source="state", state, subject="All", and status_filter="All".
State mode must not include congress, member_type, last_name, state_code, district, or custom_subject_filter_id.
State mode hides subject/status filter controls in the widget UI.

Legislation Log Examples

Representative Congress example:

[neut_legislation_log
  instance_id="legislation-lofgren-health"
  source="congress"
  member_type="Representative"
  last_name="Lofgren"
  state_code="CA"
  district="18"
  congress="119"
  subject="Health & Social Welfare"
  status_filter="All"
  show_subject_filter="false"
  show_status_filter="false"
  limit="10"
  colorway="WashedSage"]

General Congress parent-subject example:

[neut_legislation_log
  instance_id="legislation-health-general"
  source="congress"
  congress="119"
  subject="Health & Social Welfare"
  status_filter="All"
  limit="10"
  colorway="WashedSage"]

Congress custom filter example:

[neut_legislation_log
  instance_id="legislation-healthcare-access"
  source="congress"
  congress="119"
  custom_subject_filter_id="550e8400-e29b-41d4-a716-446655440000"
  status_filter="All"
  limit="10"
  colorway="WashedSage"]

State bill ledger example:

[neut_legislation_log
  instance_id="legislation-ca-activity"
  source="state"
  state="CA"
  subject="All"
  status_filter="All"
  page="1"
  limit="10"
  colorway="WashedSage"]

Supported Subjects

Use one of these values for subject:

All
Animals & Agriculture
Business & Trade
Crime
Culture and Society
Education
Energy & Conservation
Finance & Taxes
Geopolitics
Government Operations
Health & Social Welfare
Human, Civil, & Immigration Rights
Infrastructure & Housing
Labor & Employment
National Security & International Affairs
STEM

Supported Status Filters

Use one of these values for status_filter:

All
Introduced
With First Chamber
With Second Chamber
Presented to President
Became Law
Vetoed by President
Passed Resolutions

Supported Colorways

Use one of these values for colorway:

Default
Dark
Paper
WashedSage
Slate
MonoLight

The plugin also accepts these aliases:

dark-mode
washed-sage
mono-light