# useRecords

**Kind:** Function

A hook for working with all of the records (including cell values) in a
particular table. Automatically handles loading data and updating
your component when the underlying data changes.

This hook re-renders when data concerning the records changes (specifically, when cell values
change and when records are added or removed).

Returns a list of records.

```js
import {useBase, useRecords} from '@airtable/blocks/interface/ui';

 function RecordList() {
     const base = useBase();
     const table = base.tables[0];

     // grab all the records from that table
     const records = useRecords(table);

     // render a list of records:
     return (
         <ul>
             {records.map(record => {
                 return <li key={record.id}>{record.name}</li>;
             })}
         </ul>
     );
 }
```

**Parameters:**
- `table` (`Table`) — The `Table` you want the records from.

**Returns:** `Array<Record>`