GravityView (GravityKit)
GravityView renders Gravity Forms entries as searchable, sortable, filterable front-end Views without custom query code. Part of the GravityKit product suite alongside GravityActions and GravityBoard.
When to use
- Displaying Gravity Forms entries on the front-end (staff directories, portfolios, listings)
- Building searchable/filterable entry displays
- Setting up entry approval workflows
- Creating edit-entry forms for front-end user editing
- Restricting views by role or entry ownership
- Building admin workflows with automated classification
Official documentation
GravityKit ecosystem
| Product |
Purpose |
| GravityView |
Display entries as Views (lists, tables, maps, cards) |
| GravityView Pro |
Extended layouts: maps, tables, ratings, magic links |
| GravityActions |
Bulk-update, bulk-email thousands of entries at once |
| GravityBoard |
Kanban board view for entries with columns and voting |
| WordPress MCP |
Surgical block-level Gutenberg editing for AI assistants |
Procedure
1) Install
GravityView is a premium plugin. Download from your GravityKit account and install:
wp plugin install gravityview.zip --activate
wp plugin install gravityview-datatables.zip --activate # optional table layout
Or via SatisPress/Composer:
"satispress/gravityview": "*"
2) Create a View
- Views → New View
- Select the Gravity Form to pull entries from
- Choose a layout (Table, List, DataTables, Map)
- Add fields to the Multiple Entries layout (directory view)
- Add fields to the Single Entry layout (detail page)
- Configure View Settings (sorting, pagination, entry ownership)
3) Restrict by ownership and role
View Settings → Show only entries created by the current user: ✓
View Settings → Required Capability: gravityview_view_entries
// Prevent metadata exposure in public views
add_filter('gravityview/fields/custom/content_after', function($content, $field) {
if (!is_user_logged_in() && in_array($field->ID, ['internal_notes', 'api_key'])) {
return '—';
}
return $content;
}, 10, 2);
4) Entry approval workflow
- Add Approval field to your View layout
- Configure: View Settings → Approval Status → Approved only
- Gravity Connect can auto-classify submissions:
Gravity Connect Feed → classify "Flagged" →
GravityView filter: {Approval Status} = Flagged →
Admin-only view for review
5) Edit entry (front-end editing)
- Views → Edit → add fields to Edit Entry layout
- Embed with shortcode:
[gravityview id="1" context="edit"]
- Set capability: View Settings → User Edit → "Own entries only"
6) Shortcodes
[gravityview id="1"] # basic view
[gravityview id="1" page_size="20"] # paginated
[gravityview id="1" search_field="2"] # pre-filtered by field 2
[gravityview id="1" context="single" entry_id="42"] # single entry
7) MCP prototyping
Feed your GravityView structure to an LLM to generate custom layout HTML:
// Export view field config for LLM context
$view_fields = get_post_meta(get_the_ID(), '_gravityview_directory_fields', true);
echo json_encode($view_fields, JSON_PRETTY_PRINT);
Security
- Always apply entry ownership restrictions on public-facing Views
- Never expose sensitive field IDs in public shortcodes
- Use Roles and Capabilities settings to gate admin-only views
- See
wp-gravity-stack → references/security.md for the full audit script
References
wp-gravity-forms skill — forms and entries that feed Views
wp-gravity-connect skill — AI classification feeding GravityView filters
1---2name: wp-gravityview3description: Use when working with GravityView or GravityKit products: creating Views to display Gravity Forms entries on the front-end, configuring search/sort/filter, entry approval workflows, edit-entry forms, role-based access, merge tags, shortcodes, or the GravityActions/GravityBoard extensions.4license: GPL-2.0-or-later5---67# GravityView (GravityKit)89GravityView renders Gravity Forms entries as searchable, sortable, filterable front-end Views without custom query code. Part of the GravityKit product suite alongside GravityActions and GravityBoard.1011## When to use1213- Displaying Gravity Forms entries on the front-end (staff directories, portfolios, listings)14- Building searchable/filterable entry displays15- Setting up entry approval workflows16- Creating edit-entry forms for front-end user editing17- Restricting views by role or entry ownership18- Building admin workflows with automated classification1920## Official documentation2122| Resource | URL |23|----------|-----|24| GravityKit docs | https://docs.gravitykit.com/ |25| Getting started | https://www.gravitykit.com/docs/gravityview/getting-started/ |26| View setup | https://www.gravitykit.com/docs/gravityview/getting-started-gravityview/ |27| Search / filter | https://www.gravitykit.com/docs/gravityview/filter-and-sort-results/ |28| Entry approval | https://www.gravitykit.com/docs/gravityview/entry-approval/ |29| Edit entry | https://www.gravitykit.com/docs/gravityview/edit-entry/ |30| Merge tags | https://www.gravitykit.com/docs/gravityview/merge-tags/ |31| Shortcodes | https://www.gravitykit.com/docs/gravityview/shortcodes/ |32| Roles & capabilities | https://www.gravitykit.com/docs/gravityview/roles-and-capabilities/ |33| View settings | https://www.gravitykit.com/docs/gravityview/view-settings/ |34| Common problems | https://www.gravitykit.com/docs/gravityview/common-problems/ |35| FAQ | https://www.gravitykit.com/docs/gravityview/faq/ |36| **Developer docs (hooks)** | **https://www.gravitykit.dev/** |37| Foundation framework | https://www.gravitykit.dev/docs/foundation/ |38| Account | https://account.gravitykit.com |3940## GravityKit ecosystem4142| Product | Purpose |43|---------|---------|44| **GravityView** | Display entries as Views (lists, tables, maps, cards) |45| **GravityView Pro** | Extended layouts: maps, tables, ratings, magic links |46| **GravityActions** | Bulk-update, bulk-email thousands of entries at once |47| **GravityBoard** | Kanban board view for entries with columns and voting |48| **WordPress MCP** | Surgical block-level Gutenberg editing for AI assistants |4950- Account: https://account.gravitykit.com51- GitHub org: https://github.com/GravityKit52- **Developer docs** (hooks, Foundation, 37 products): https://www.gravitykit.dev/5354---5556## Procedure5758### 1) Install5960GravityView is a premium plugin. Download from your GravityKit account and install:6162```bash63wp plugin install gravityview.zip --activate64wp plugin install gravityview-datatables.zip --activate # optional table layout65```6667Or via SatisPress/Composer:6869```json70"satispress/gravityview": "*"71```7273### 2) Create a View74751. **Views → New View**762. Select the Gravity Form to pull entries from773. Choose a layout (Table, List, DataTables, Map)784. Add fields to the **Multiple Entries** layout (directory view)795. Add fields to the **Single Entry** layout (detail page)806. Configure **View Settings** (sorting, pagination, entry ownership)8182### 3) Restrict by ownership and role8384```85View Settings → Show only entries created by the current user: ✓86View Settings → Required Capability: gravityview_view_entries87```8889```php90// Prevent metadata exposure in public views91add_filter('gravityview/fields/custom/content_after', function($content, $field) {92 if (!is_user_logged_in() && in_array($field->ID, ['internal_notes', 'api_key'])) {93 return '—';94 }95 return $content;96}, 10, 2);97```9899### 4) Entry approval workflow1001011. Add **Approval** field to your View layout1022. Configure: **View Settings → Approval Status → Approved only**1033. Gravity Connect can auto-classify submissions:104105```106Gravity Connect Feed → classify "Flagged" →107GravityView filter: {Approval Status} = Flagged →108Admin-only view for review109```110111### 5) Edit entry (front-end editing)1121131. **Views → Edit** → add fields to **Edit Entry** layout1142. Embed with shortcode: `[gravityview id="1" context="edit"]`1153. Set capability: **View Settings → User Edit** → "Own entries only"116117### 6) Shortcodes118119```120[gravityview id="1"] # basic view121[gravityview id="1" page_size="20"] # paginated122[gravityview id="1" search_field="2"] # pre-filtered by field 2123[gravityview id="1" context="single" entry_id="42"] # single entry124```125126### 7) MCP prototyping127128Feed your GravityView structure to an LLM to generate custom layout HTML:129130```php131// Export view field config for LLM context132$view_fields = get_post_meta(get_the_ID(), '_gravityview_directory_fields', true);133echo json_encode($view_fields, JSON_PRETTY_PRINT);134```135136---137138## Security139140- Always apply entry ownership restrictions on public-facing Views141- Never expose sensitive field IDs in public shortcodes142- Use **Roles and Capabilities** settings to gate admin-only views143- See `wp-gravity-stack → references/security.md` for the full audit script144145## References146147- `wp-gravity-forms` skill — forms and entries that feed Views148- `wp-gravity-connect` skill — AI classification feeding GravityView filters