Version

WARNING You're browsing the documentation for an upcoming version of Laravel DataTables. The documentation and features of this release are subject to change.

Installation

This guide covers how to install Laravel DataTables packages using Composer.

Requirements

Requirement	Version	Notes
PHP	8.3+	Required
Laravel	13.x	Latest stable
DataTables.js	1.x or 2.x	datatables.net

Installation Methods

Option 1: Core Package Only

Install the core package when you need basic DataTables functionality:

composer require yajra/laravel-datatables-oracle:"^13.0"

Option 2: All-in-One Package

Use the all-in-one installer when you need most DataTables plugins (Buttons, HTML Builder):

composer require yajra/laravel-datatables:"^13.0"

[!TIP] The all-in-one package includes HTML Builder, Buttons, and other commonly used plugins.

Quick Install All-in-One

For a complete setup with all plugins:

# Install the all-in-one package
composer require yajra/laravel-datatables:"^13.0"
 
# Install DataTables assets (using Vite)
npm i laravel-datatables-vite --save-dev

Configuration

Publishing the configuration file is optional but recommended for customization:

php artisan vendor:publish --tag=datatables

This creates config/datatables.php with default settings:

<?php
 
return [
    /*
     * Smart search adds wildcards automatically
     */
    'smart' => true,
 
    /*
     * Case insensitive searching
     */
    'case_insensitive' => true,
 
    /*
     * Wild card character for partial matching
     */
    'use_wildcards' => false,
 
    /*
     * DataTables internal index column name
     */
    'index_column' => 'DT_RowIndex',
 
    /*
     * Error message configuration
     */
    'error' => env('DATATABLES_ERROR', null),
 
    /*
     * NULLS LAST SQL pattern for PostgreSQL & Oracle
     */
    'nulls_last_sql' => '%s %s NULLS LAST',
];

Package Structure

Laravel DataTables is split into multiple packages:

laravel-datatables/
├── Core Package (required)
│   └── yajra/laravel-datatables-oracle
│
├── HTML Builder (optional)
│   └── yajra/laravel-datatables-html
│
├── Buttons (optional)
│   └── yajra/laravel-datatables-buttons
│
├── Editor (optional - premium license required)
│   └── yajra/laravel-datatables-editor
│
├── Export (optional)
│   └── yajra/laravel-datatables-export
│
└── Fractal (optional)
    └── yajra/laravel-datatables-fractal

Next Steps

Quick Starter → Get up and running in 15 minutes with a complete example.

HTML Builder → Learn about the HTML Builder plugin for generating tables.

Buttons Plugin → Add export functionality (Excel, CSV, PDF).

Edit this page on GitHub